Troubleshooting Mattermaps

Written by Heinz Hambrock

Troubleshooting

I cannot access my account. How can I reset my password?

 

Find the right sustainability guidance for your product

 

Why am I getting an error when requesting an OAuth token?

 

OIDC SSO Setup for Mattermaps (Generic Provider)

 

Okta Integration Guide for Mattermaps (Auth0 Enterprise Connection)

 

Azure AD (Entra ID) SSO Setup for Mattermaps

 
 

Here are the step-by-step instructions for logging into Mattermaps using your MattermapsID:

Go to the Mattermaps website and look for the login section.

Log into Mattermaps.

Forgot Your Password? If you've forgotten your password, click the "Forgot password?" link below the login fields.

This will prompt you to enter the email address linked to your MattermapsID. Once you submit this, you'll receive an email from MattermapsID with a link to reset your password.

Using an Authenticator App. If you've linked your MattermapsID to an authenticator app, you'll see a QR code on the login screen. Use your authenticator app to scan this code and complete the login process.

Lost Phone or Authenticator App Access? If you've lost access to your authenticator app, contact the Mattermaps support team. Submit a ticket with the support team so they can help you reset your login information. Make sure the email address you provide matches what's on file for your MattermapsID.

As a life cycle assessment or sustainability expert, you're often tasked with navigating the complex landscape of sustainability frameworks, standards, and guidance documents. We often get asked How can I best find the guidance to my product category? Or is there a guidance for my product category, and which one should I use?

Thanks to our partners at ESTANIUM we bring you today a new tool that can help you find the right sustainability guidance for your needs.

The Estainium Knowledge Hub is a free, online tool that allows you to quickly search and identify the most relevant sustainability guidance for your product or industry. Developed by the Estainium Association, this tool puts a wealth of sustainability knowledge at your fingertips.

The Estainium Knowledge Hub allows you to:

Search by product category, industry, or keyword to find applicable sustainability standards, guidelines, and frameworks.

Filter results by criteria like scope, intended audience, and geographic relevance.

Access detailed information on each guidance document, including a summary, key requirements, and links to download or learn more.

This makes it easy to pinpoint the most appropriate sustainability guidance to follow for your specific product or service - saving you time and ensuring you're on the right track.

Real-World Example: Let's say you're a sustainability manager at a furniture manufacturing company. You need to find the best sustainability guidance to follow for your wood furniture products.

Using the Estainium Knowledge Hub, you can simply search for "food" and filter the results to show only guidance relevant to the furniture industry. The tool will show options like:

ISO 14024 - Environmental labels and declarations

ANSI/BIFMA e3-2019 Furniture Sustainability Standard

UN Global Compact - Sustainable Procurement Guidance

With the key details on each guideline, you can quickly evaluate which one best fits your needs in terms of scope, requirements, and geographic applicability. The Estainium Knowledge Hub takes the guesswork out of navigating the sustainability landscape.

 

This error can occur when the audience value in the OAuth token request is incorrect.

For Mattermaps, the audience must match the documented value exactly. Even a small difference, such as a missing trailing slash, can cause the token request to fail.


What should the correct audience value be?

Use the following audience value:

https://app.mattermaps.com/

Make sure the URL includes the trailing slash / at the end.


What is the incorrect audience value?

The following value is incorrect because it is missing the trailing slash:

https://app.mattermaps.com

How do I fix the issue?

Update the audience value in your OAuth token request.

Change this:

https://app.mattermaps.com

To this:

https://app.mattermaps.com/

Then retry the token request.

Follow these steps to configure an OpenID Connect (OIDC) application with your identity provider
to enable Single Sign-On (SSO) with Mattermaps.

1. Create OIDC Application

  1. Log in to your Identity Provider admin console
  2. Create a new application / client
  3. Select protocol: OpenID Connect (OIDC)
  4. Set application type: Web / Confidential client
  5. Enter application name (e.g. 'Mattermaps Integration')

2. Configure Redirect URI

  1. Add the following Redirect URI (Callback URL): https://mattermaps.eu.auth0.com/login/callback
    This is required for successful authentication flow.

3. Configure Scopes

  1. Ensure the following scopes are enabled:
  2. openid
  3. profile
  4. email

4. Send Us These Details

  1. Client ID
  2. Client Secret
  3. OpenID Connect Discovery URL (e.g. https://your-domain/.well-known/openid-configuration)
  4. User email domains (e.g. company.com)


Once received, we will complete the setup and notify you when ready.
 

This guide explains how to configure an OpenID Connect (OIDC) application in Okta to enable Single Sign-On (SSO) with Mattermaps via Auth0.

1. Create and Configure Application in Okta1 

  1. Log in to the Okta Admin Console.
  2. Navigate to Applications → Applications.
  3. Click 'Create App Integration'.
  4. Select 'OIDC - OpenID Connect' and 'Web Application'.
  5. Click 'Next'.
  6. Enter an application name of your choice (e.g., 'Mattermaps Integration').
  7. Set Sign-in redirect URI to: https://mattermaps.eu.auth0.com/login/callback
  8. Leave other settings as default unless required by your organization.

2. Assign Users

  1. Assign users or groups who should have access to Mattermaps.

3. Provide Configuration Details

After creating the application, please send us the following information:

  1. Client ID
  2. Client Secret
  3. Okta Domain (e.g., https://your-company.okta.com)
  4. Email domains used by your users (e.g., company.com)

Once we receive this information, we will complete the configuration on our side and notify you when the integration is ready for testing.

 

 

Follow these steps to configure an OpenID Connect (OIDC) application in Microsoft Entra ID (Azure AD) for Single Sign-On (SSO) with Mattermaps. 

1. Register Application 

  1. Go to Azure Portal → Microsoft Entra ID 
  2. Navigate to App registrations 
  3. Click 'New registration' 
  4. Enter application name (e.g. 'Mattermaps Integration') 
  5. Select 'Accounts in this organizational directory only' 
  6. Click 'Register' 

You should see Application (client) ID and Directory (tenant) ID on the overview page. 

2. Configure Authentication 

  1. Open 'Authentication' tab 
  2. Click 'Add a platform' → Web 
  3. Set Redirect URI: https://mattermaps.eu.auth0.com/login/callback 
  4. Enable 'ID tokens' under Implicit grant (if visible) 
  5. Save changes 

Look for Redirect URI field under Web platform configuration.

3. Create Client Secret

  1. Go to 'Certificates & secrets' 
  2. Click 'New client secret' 
  3. Add description and expiration 
  4. Copy the secret value (it will not be shown again) 

4. Send Us These Details

  1. Application (client) ID 
  2. Client Secret 
  3. Directory (tenant) ID 
  4. Email domains used by your users (e.g. company.com) 

Once received, we will complete the setup and notify you when ready.