Custom Domains
Overview
The Custom Domains module enables you to use your own domain names for FormKiQ Web and API endpoints, replacing the default AWS domains with your branded URLs. Custom domains are included in Essentials, Advanced, and Enterprise and use AWS services including Route 53 and Certificate Manager. Certificates, DNS access, and deployment configuration are still required. See editions and licensing.
Default vs Custom Domains
| Component | Default Domain | Custom Domain Example |
|---|---|---|
| CloudFront Console | xxxxxx.cloudfront.net | console.yourdomain.com |
| API Gateway | xxxxxx.execute-api.region.amazonaws.com | api.yourdomain.com |
Prerequisites
- SSL certificates configured in AWS Certificate Manager
- Console certificate must be in us-east-1 region (CloudFront requirement)
- Appropriate DNS access for domain configuration
Configuration Parameters
Domain Configuration
| Parameter | Description | Example |
|---|---|---|
| ConsoleDomain | FormKiQ Web URL | console.yourdomain.com |
| HttpApiDomain | HTTP API endpoint | api.yourdomain.com |
| IamApiDomain | IAM API endpoint | iamapi.yourdomain.com |
| KeyApiDomain | Key API endpoint | keyapi.yourdomain.com |
| AuthApiDomain | Auth API endpoint | auth.yourdomain.com |
Certificate Configuration
| Parameter | Description | Required Region |
|---|---|---|
| ConsoleCertificateArn | Console SSL certificate ARN | us-east-1 |
| HttpCertificateArn | HTTP API certificate ARN | Any |
| IamCertificateArn | IAM API certificate ARN | Any |
| KeyCertificateArn | Key API certificate ARN | Any |
| AuthCertificateArn | Auth API certificate ARN | Any |
Optional Configuration
| Parameter | Description |
|---|---|
| HostedZoneId | Route 53 Hosted Zone ID for automatic DNS record creation |
Implementation Steps
1. Deploy Custom Domains
- Prepare SSL certificates in AWS Certificate Manager
- Configure domain parameters
- Deploy CloudFormation template
- Note the stack name for FormKiQ integration
2. Connect to FormKiQ
- Open CloudFormation console
- Select your FormKiQ installation
- Click "Update"
- Choose "Use existing template"
- Set
CertificateStackNameto your Custom Domains stack name - Complete the stack update
Use Cases
Internal Usage
- Replace AWS domains with branded URLs
- Improve URL readability for internal users
- Maintain consistent branding
External Access
- Professional branded endpoints
- Enhanced security with SSL
- Simplified API access
AWS Services Used
- Amazon Route 53 for DNS management
- AWS Certificate Manager for SSL certificates
- Amazon CloudFront for console delivery
- Amazon API Gateway for API endpoints
Important
Console certificates must be in the us-east-1 region due to CloudFront requirements