Custom Domains

🚧

v0 stacks

These steps apply to v2 stacks. If your stack is on v0, contact Sublime to migrate to v2 before you set up a custom domain or click tracking. To check your version, find the StackVersion value on the Outputs tab of your Sublime-Platform stack.

On v2 stacks, you set your platform's host name, such as sublime.example.com, with the platformingresshost parameter when you deploy. See the AWS CloudFormation Install requirements.

Setting up a domain for Track Link Clicks Action and Quarantine Digests

When enabling Track Link Clicks Action or Quarantine Digests, you need a subdomain for the redirect traffic. The click-tracking load balancer serves the redirect. subdomain of your platformingresshost. For example, if your host name is sublime.myorg.com, the click-tracking domain is redirect.sublime.myorg.com.

1. In the AWS console, navigate to the same region in which you deployed the Sublime Platform.
2. Request a public certificate in AWS Certificate Manager for redirect.<your host name>, or use a wildcard certificate that covers it (for example, *.sublime.myorg.com). The load balancer finds the certificate by host name, so you don't attach it yourself.
3. In the EC2 Load Balancers interface, find the sublime-platform-click-tracking load balancer and copy its DNS name.
4. Create a CNAME DNS record pointing redirect.<your host name> to that DNS name.
5. Set the redirect service DNS name to https://redirect.<your host name>. This can be done on the Track Link Clicks Action page or via a direct API call to PATCH /v1/orgs/mine/settings with {"url_defense_base_url": "https://redirect.<your host name>"}.

The click-tracking load balancer also routes Quarantine Digest and Phishing Simulation traffic, so no further load balancer changes are needed.