Skip to main content

Localization

Pages

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

Language selection

By default, this service will use the browser to determine the language of visualization, falling back into English if needed. But, if there is a special need to force language, it is possible to pass into query params of auth request special param hl which will contain language code, like (en, it and so on)

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, 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 properly functioning 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 a customization file How-to-customize

Back to top