Skip to main content

Localization

Pages

The landing page is the initial webpage that users encounter when they access the OIDC SSI Gateway. It consists of three files: index.html, 404.html, and 500.html.

Template customization

The template is customizable using a .zip file. The .zip file must contain at least the following files:

  • index-<lang>.html: the main HTML
  • 404-<lang>.html: the client_id not found
  • 500-<lang>.html: generic error

The <lang> is the language code, for example en or it. The zip file must be included into helm_chart/values/customizations/<wallet_name>/customizer.zip. In the helm chart isCustomizationEnabled: true must be set.

This configuration can be made only by requesting support for managed solutions or manually in the case of self-hosted solutions.

Template editing

The main page, index.html, displays a widget that enables users to authenticate with the OIDC SSI Gateway. It has several variables that are customizable during the client_id creation process. These variables include:

  • {{domain}}: the client's domain, usually employed for redirecting back.
  • {{provider_img}}: the client's image, commonly used for branding purposes.
  • {{client_id}}: the client's unique ID.
  • {{redirect_url}}: the client's callback URL, which is typically an RP callback URL.

Additionally, there are system-level variables used to create the widget URL, including:

  • {{proof_id}}: used to identify the proof.
  • {{agent}}: the agent endpoint used to connect to the agent.
  • {{org_id}}: identifies the organization.
  • {{proof_template}}: identifies the proof template used in the widget.
  • {{oob}}: identifies the out-of-band connection used in the widget.
  • {{service}}: identifies the DAPI service used in the widget on the agent callback.

It is important to note that editing these system-level variables is not recommended as they are crucial to the proper functioning of the OIDC SSI Gateway. Only edit the content between <!-- DO NOT TOUCH FROM HERE --> and <!-- DO NOT TOUCH UNTIL HERE --> if you have a clear understanding of what you are doing.

The 500.html page is a generic error page that displays an error code. It includes a variable, {{ message }}, which provides the support team with a numeric code that can be used to troubleshoot issues.

See an example of customization file How-to-customize

Back to top