Mnestix AAS Generator

Important

The documentation for Mnestix Proxy is located at https://github.com/eclipse-mnestix/mnestix-proxy/wiki. For more information about proxy setup, configuration, and advanced usage, please refer to the official documentation there.

What is Mnestix AAS Generator?

The Mnestix API enhances the capabilities of the Mnestix Viewer, an Asset Administration Shell viewer. Built with ASP.NET Core 8, it offers the following advanced features:

• AAS Creation Endpoint: An endpoint for creating Asset Administration Shells (AAS) using only the assetId short.
• AasRelationship Endpoint: An endpoint to return AAS derived from a specified aasId.
• Custom Submodel Templates: Functionality for building custom submodel templates based on default templates, which can be combined with the AAS creation endpoint to efficiently create large numbers of AAS and map data into the submodels.

Feature Overview

Below you can find an overview of the Mnestix Ecosystem and how the different components work together.

Mnestix AAS Generator (formerly known as the Data Ingest Endpoint)

On the right side of the diagram is the Eclipse Mnestix Browser component that enables browsing through multiple repositories and your AAS infrastructure.

The Mnestix Template Builder is already integrated within Mnestix Browser and is activated when the Mnestix AAS Generator environment variable is set. See Mnestix Configuration Settings for more information.

Run locally

Requirements

• Linux or WSL
• Docker
• Docker-Compose

Instructions:

1. Copy the compose.yml code

   Found here

2. Create the compose.yml file

   Create a file in your local directory with the name compose.yml and paste the copied code in there.

3. Run the application

   Navigate to the directory where the compose.yml is, and run the following command:

   docker compose up
   

4. Visit Mnestix

   Open your Browser and go to http://localhost:5064/swagger/index.html to see Swagger documentation and all public exposed endpoints.

5. Change Enviromental Settings

The Mnestix AAS Generator is configured using environment variables in your compose.yml file. Below are the key settings you can adjust:

API Key

• CustomerEndpointsSecurity__ApiKey:
  Set your API key to secure all API endpoints except the AasList endpoint.
  Example:
  CustomerEndpointsSecurity__ApiKey: YOUR_API_KEY_HERE

  Replace YOUR_API_KEY_HERE with your actual API key.

Feature Flags

• Features__UseAuthentication:
  Enable or disable authentication for the backend.
  Example:
  Features__UseAuthentication: true
  Set to true to require authentication, or false to disable.

Authentication Providers

You can secure the API using Microsoft Entra ID (Azure AD) or an OpenID Connect provider (e.g., Keycloak).

Azure AD Configuration:

• AzureAd__Domain: Your Azure domain
• AzureAd__TenantId: Your Azure tenant ID
• AzureAd__ClientId: Your Azure client ID

OpenID Connect Configuration:

• OpenId__EnableOpenIdAuth: Set to "true" to enable OIDC authentication
• OpenId__Issuer: OIDC issuer URL (e.g., Keycloak realm)
• OpenId__ClientID: OIDC client ID
• OpenId__RequireHttpsMetadata: "false" for development, "true" for production

Repository OpenID Connect (for Basyx Repository):

• RepositoryOpenIdConnect__EnableRepositoryOpenIdAuth: "true" to enable
• RepositoryOpenIdConnect__Authority: OIDC authority URL
• RepositoryOpenIdConnect__DiscoveryEndpoint: Usually .well-known/openid-configuration
• RepositoryOpenIdConnect__ClientId: Client ID for repository access
• RepositoryOpenIdConnect__ClientSecret: Client secret for repository access
• RepositoryOpenIdConnect__ValidateIssuer: "true" for production

Connection to AAS Repository and Submodel repository infrastructure (here via Proxy):

• ServerUrls:
  Defines the internal URL for the Mnestix proxy to access the repository. Example:
  ServerUrls: 'http://mnestix-proxy:5065/repo/'

  Adjust this value if your proxy or repository endpoint changes.

Tip:
For production, always use secure values and restrict public access to MongoDB and API endpoints.