Custom Domains
The custom domains feature is available to customers on specific pricing plans. Refer to your pricing plan or contract, or contact the Prismatic support team to learn more.
You can choose to interact with the Prismatic platform through a custom domain that you control.
For example, you might want to white-label Prismatic so your team members and customers access https://integrations.your-company.com
instead of https://app.prismatic.io.
To configure a custom domain, please reach out to our support team, and let us know what subdomain (like https://integrations.your-company.com
) you would like to use.
We'll create an SOA record for that subdomain along with a few A and CNAME records for things like web app access, webhook invocation, and OAuth 2.0 callbacks:
https://integrations.your-company.com
- web app and embedded URLhttps://hooks.integrations.your-company.com
- webhookshttps://**oauth2.integrations**.your-company.com
- OAuth 2.0 callback
Once we have those records ready, you'll just need to create an NS record to point to a list of nameservers we'll provide you. Note: some DNS providers represent a list of NS servers as separate NS records (one server per record), and others have single NS records with a list of values.
Once your domain is white-labeled, your OAuth2 apps can use https://oauth2.integrations.your-company.com/callback
as a callback URL.
Note that once a subdomain is configured, you can access your tenant through either the custom domain or the default Prismatic domain. Custom domains are not tenant-specific. If you have prod and dev tenants, both tenants can use the custom domain you establish.
- If you access or embed Prismatic via https://app.prismatic.io, you will see webhook and OAuth URLs with the Prismatic domain.
- If you access or embed Prismatic via your custom domain like
https://integrations.your-company.com
, you will see webhook and OAuth URLs with your custom domain.