Asset Admin Shell Repository

IEC 63278 Asset Admin Shell Repository reference implementation using C# and .Net6.0.

Features

1. Loading of Asset Admin Shells V1, V2 and V3 (both XML and JSON), but always saving in V3 format, leveraging both JSON and XML)
2. Standardized AAS REST interface (as specified in part 2 of the AAS spec)
3. Swagger endpoint at /swagger
4. IDTA AASX Package Explorer client interface support
5. Joint CESMII/Plattform Industrie 4.0/IDTA/DTC Carbon Reporting Demonstrator integration
6. Product Carbon Footprint (PCF) calculation (based on GHG Protocol specification) for the production line simulation which is part of the DTC's Manufacturing Ontologies reference solution.
7. WattTime integration
8. Azure Data Explorer data source integration
9. Integrated AAS browser
10. Integrated OPC UA Nodeset file browser
11. Integrated AutomationML file browser
12. Basic authentication header support (use "admin" and ServicePassword environment variable to set password)
13. Local storage of AASX package files (in the server's root directory)
14. Cloud storage of AASX package files

Usage

Docker containers are automatically built. Simply run the app on a Docker-enabled PC via:

docker run -p 80:80 ghcr.io/digitaltwinconsortium/aas-repository:masterv3

And then point your browser to http://localhost.

Required Environment variables

1. ServicePassword: Password to access the service via basic authentication header

Optional Environment variables

1. HostingPlatform: The hosting platform of the repository. Current options are Azure (the default is to run it locally)
2. UACLUsername: OPC Foundation UA Cloud Library username
3. UACLPassword: OPC Foundation UA Cloud Library password
4. ADX_HOST: Azure Data Explorer host name
5. ADX_DB: Azure Data Explorer database name
6. AAD_TENANT: Azure Active Directory tenant ID of your Azure subscription (GUID)
7. AAD_APPLICATION_ID: Azure Active Directory application ID (GUID, set this up via an app registration in the Azure Portal)
8. AAD_APPLICATION_KEY: Azure Active Directory application key (with data owner access to ADX cluster and database, create a secret within your AAD app registration)
9. ADX_QUERY_INTERVAL: The query interval for the ADX database
10. WATTTIME_USER: WattTime service username
11. WATTTIME_PASSWORD: WattTime service password
12. WATTTIME_LATITUDE: WattTime location to query
13. WATTTIME_LONGITUDE: WattTime location to query
14. CALCULATE_PCF: Set to "1" to enable PCF calculation
15. CARBON_REPORTING: Set to "1" to enable carbon reporting
16. USE_JSON_SERIALIZATION: Set "1" to enable saving AAS spec in JSON format (within AASX file)