Start Service#

New in version 2.0.

ESS provides a service that acts as the starting point for the ESS user interface.

Start Service Endpoint#

ESS Start Service hosts an application that runs at:

https://start.<ESS Domain>

The start application allows a user to sign up or login with the Identity Provider. As part of this flow, the application provisions the user with a WebID and a Pod.

Custom Start Application#

You can replace the default start application with a custom start application. Both the WebID Service and Pod Provisioning Service expose endpoints that can be used by your application to create a WebID and a Pod for a user. For details, see:

Important

If using a custom start application, update:

QUARKUS_OIDC_CLIENT_ID configuration for the Start service and
INRUPT_START_CLIENT_ID and INRUPT_WEBID_ALLOWED_CLIENT_IDS configuration for the WebID service.

Configuration#

As part of the installation process, Inrupt provides base Kustomize overlays and associated files that require deployment-specific configuration inputs.

The following configuration options are available for the service and may be set as part of updating the inputs for your deployment. The Inrupt-provided base Kustomize overlays may be using updated configuration values that differ from the default values.

INRUPT_PROVISION_HTTP_BASE_URL#: The base URL of the Pod Provisioning Service.

Important

The value requires a trailing slash /; e.g., https://provision.{ESS_DOMAIN}/.

INRUPT_WEBID_HTTP_BASE_URL#: The base URL of the WebID Service.

Important

The value requires a trailing slash /; e.g., https://id.{ESS DOMAIN}/.

QUARKUS_LOG_LEVEL#

Default: INFO

Logging level.

QUARKUS_OIDC_AUTH_SERVER_URL#: The URL of the OpenID Provider.

QUARKUS_OIDC_CLIENT_ID#

The Client Identifier (i.e., the URL that dereferences to a Client ID document) of the start app for signing in/up with the Identity Provider.

Kafka Configuration#

Tip