| The Team or Apps UI loads very slowly. |
Incorrect Dependency Manager host or API keys in Team settings. |
Check dependency manager backend and modify in "My Teams" > Settings". |
|
|
Also check system & metaport log for errors. |
| Metaport doesn't show my apps' dependencies, even though I've configured a backend in Team settings. |
Incorrect Dependency Manager host. |
If using the Dependency Track backend, ensure you're using the right docker host e.g. dtrack-apiserver:8080. |
|
SBOM hasn't been sent to backend or was sent to the wrong project. |
Ensure an SBOM was generated and sent using the correct project ID. |
|
Incorrect API Token |
Check that you're using the correct token from your dependency management software. Also check system log for errors. |
| "Dependency Manager Settings" UI control is not visible. |
Metaport hasn't been built with the MP_DEPMANAGER environment variable. |
Add the MP_DEPMANAGER environment variable e.g. MP_DEPMANAGER=DependencyTrack. |
| Cannot import my app's maintenance calendar into my calendar client e.g. Mozilla Thunderbird. |
You're using HTTP to import. Metaport .ics files aren't designed to be delivered over http. |
Download the .ics file and import it into your calendar. |
| I'm using Keycloak, but the "Login with Keycloak" button doesn't do anything. |
|
In development environments, try bringing up the Metaport & services simultaneously and pass the --build option to docker-compose. |
| Metaport displays "Unavailable" for API User's "API Key" field or emits errors when attempting to decrypt email attachments. |
The Metaport encryption key was accidentally removed or deleted, possibly due to being compromised. |
Metaport should automatically generate a new key, but all existing API User accounts will need to be removed and re-created by a superuser. |
| My app is using "Email" mode but I can't see any change in the dashboard. |
The selected app doesn't have "Email" set as its transport mode. |
Ensure the app has "Email" set and saved, prior to sending data to it. |
| My app is using "Email" mode but I can't see any change in the dashboard. |
The selected app may be using an incompatible public key. |
Ensure the app is using a public key derived from the Metaport private key. |
| All of my teams' apps are receiving "Access Denied" when reporting in. |
The master encryption key has been removed or deleted. |
If possible, re-instate the encryption key. Otherwise regenerate it with ./bin/setup.sh after which all API user accounts will need to have their passwords reset!. This can be done on a per-team basis from within the Metaport UI. |
| The agent returns an "Identifier Mismatch" error from Metaport. |
An application in Metaport is unique based on: Identifier, Domain and Environment. If any of these differ from a known app, Metaport will refuse the request. |
Tweak the command-line switches passed to the agent, or you may need to delete the app in Metaport and re-create it. |
| Selecting an app from the results after searching by vulnerability takes a long time to load. |
The performance of this section is a known issue. |
Select the appropriate team name and select the "Applications" tab, then select the desired team. |
| I keep getting a "Relaying disallowed" error from my SMTP host. |
Your host or account with your host has restrictions on the sender address. |
Set the MAILER_FROM environment variable in your agent's environment to something permitted by your SMTP host. |
| I accepted an invite, but cannot see any teams. |
You have not yet been allocated to a team. Perhaps you accepted the invite faster than the administering user was able to complete their efforts. |
Wait a while longer or contact your Metaport administrator. |
| My app(s) show as "Unknown" in the Metaport UI. |
One or more apps haven't yet successfully reported-in to Metaport. |
Refer to the agent docs and check with a developer that no errors are generated by cron or from within CI pipelines when executing commands. |
| I can see a "P" icon next to some of my app's fields. |
Data has been sent from a CI pipeline, and the letter "P" stands for "Provisional", indicating that the data is not yet finalised or representative of a production system. |
N/A |