| 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 a message that they are "missing its components" in the Metaport UI. |
One or more apps haven't yet successfully reported-in to Metaport or one or more components are not properly registered. |
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. Also check with your Metaport administrator that the expected component and version both exist via the "Settings" area. |
| 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 |
| As an administrator, I can't see the latest version of my desired framework/runtime/operating-system. |
Metaport's database doesn't yet include the supporting component data. |
Configure the server to execute the componentimport task regularly e.g. daily (Full command is: vendor/bin/sake dev/tasks/componentimport). |
| I can't see the "Dependency Manager" settings in my teams' "Settings" area |
The environment variable MP_DEPMANAGER is empty, not set, or set to "Classic". |
Update MP_DEPMANAGER with the name of the correct Metaport backend e.g. DependencyTrack. |
| I've enabled "DependencyTrack" as Metaport's dependency Manager, and the test connection action works, but I can't see any dependencies. |
You may have forgotton to add the Dependency Track Project UUID into your Metaport app. |
Get the Dependency Track project UUID and paste it into the app's "Dependency Manager Project ID" field in Metaport. |