Skip to main content

Create a did:web for custom domains

As part of our paid plans, you can configure a custom domain to work with a particular tenant to represent your brand and instil trust with end-users.

When you have an external domain configured as a custom domain for your tenant, Sovrin only hosts your custom domain did:web in the well-known/did.json folder.

Thus, when you create a did:web for that domain you must use the custom domain's URL instead of your tenant's URL. Any did:web created with your tenant's URL will not be available as they are not hosted on the Sovrin platform.

Request​

Make the following request to create a for a custom domain:

POST https://api.sovrin.one/v1/dids
{
  "method": "web",
  "options": {
    "url": "YOUR_CUSTOM_DOMAIN"
  }
}

To make this did:web available, you can either:

  • Host it on your custom domain under https://YOUR_CUSTOM_DOMAIN/.well-known/did.json. refer to Self hosting on Host a did:web for more information.

  • Redirect any https://YOUR_CUSTOM_DOMAIN/.well-known/did.json requests to https://YOUR_TENANT_SUBDOMAIN.vii.sovrin.one/.well-known/did.json. Refer to Redirects on Use a Custom Domain for more information.