Custom domains and SSL certificates

Use URL mapping in an environment to assign relative paths to hosted page URLs or websites. Use SSL Certificate to upload a certificate for your own domain and review the certificate currently hosted in the environment.

The SSL settings also show the environment IP address to use when configuring your domain's DNS record.

Before you start

Open the settings for an existing environment that your account can access. The settings menu includes URL mapping and SSL Certificate.

To map content, its project must be hosted in the environment. The hosted page selector lists URLs from active projects. Website choices are available when the environment's software version supports website mapping, and the website selector lists active websites from those projects.

To use your own domain, you need access to its DNS settings and the certificate files you want to upload.

Certificate upload and deletion require the corresponding account rights. See Roles and restrictions for general access information.

Configure URL mappings

1. In the environment settings, select URL mapping.
2. Select Add new URL mapping.
3. Enter a Relative URL, such as /home or /.
4. If URL Type is available, choose Hosted Page or Website. Select the destination from the corresponding list, where choices are grouped by project.
5. Select Save All URL mapping.
6. Confirm the action, select Save.

Saving applies the mappings to the environment. After a success request the table will be automatically refreshed.

The form provides a relative path field; it does not provide an editable domain field. Configure your domain's DNS separately, as described in Point your domain to the environment.

Relative URL rules

Every row needs a Relative URL. An empty value prevents saving. Choose a hosted page or website for each mapping you want to save.

Enter a path without a protocol or hostname. An absolute URL is rejected as an invalid relative URL. If the value includes a query string, the query string is removed when saving.

Saved paths have a leading /. Except for the root path /, hosted page paths have no trailing /, and website paths end in /.

If the environment is not ready for the mapping table to load, the page displays Not ready yet and URL mapping is not enabled while server is not ready.

Open or remove a mapping

For an existing mapping, select the external-link icon beside Relative URL to open the environment's Web URL with that path in a new tab. After you change the path, the icon is disabled until the changed value is saved or restored to its original value.

To remove a saved mapping:

1. Select the row's delete button.
2. Review Delete this URL mapping?.
3. Enter DELETE in the confirmation field and select Delete.

The confirmation warns that deletion is permanent and cannot be undone. A successful request refreshes the table. Deleting a newly added row that has not been saved removes it from the form without a confirmation.

Point your domain to the environment

1. In the environment settings, select SSL Certificate.
2. Find the environment IP address in the DNS guidance.
3. At your domain provider, add or update an A record for your domain or subdomain so it points to that IP address.

The settings show an example using www.mydomain.com and the current environment IP address. Use your own domain or subdomain in the DNS record.

Upload an SSL certificate

Under Upload Certificate. Which type of certificate do you have?, choose the option that matches your files. Selecting an option displays its upload fields.

Upload a PEM file

1. Select I have a PEM file.
2. In PEM file, choose your file. The file picker accepts .pem and .txt files.
3. Select Upload PEM file.

The PEM content must contain a readable private key and certificate. It can also contain root and intermediate certificates for the certificate chain.

Upload separate certificate files

1. Select I have separated certificate files.
2. Choose the required Private Key file. The field lists .key and .txt as examples.
3. Choose the required Domain Certificate file. Its file picker accepts .crt, .cer, and .txt files.
4. If you have certificate chain files, add them under Root and Intermediate certificate files. You can select a .ca-bundle file or separate root and intermediate files; the picker accepts .ca-bundle, .crt, .cer, and .txt files and allows multiple selections.
5. Select Upload Certificates.

The chain field is optional in the upload form. The field's help explains that the chain improves compatibility with browsers and other clients.

Upload results and errors

After the upload, Flowize returns to SSL Certificate. A successful upload displays Your SSL certificate has been saved successfully.

The form prevents submission if the required PEM file, private key file, or domain certificate file is missing. Unreadable private key or certificate content can also cause the upload to fail.

Expired certificates are rejected. The error shows the expiration date and asks you to provide a valid certificate. Other upload failures display SSL Certificate is not valid. Please provide a valid certificate.

Review the current certificate

Open SSL Certificate to load Current SSL Certificate. The details can include Domain, domain contact and organization information, Valid from, Valid until, and issuer information. A field appears only when its value is available in the certificate.

Check Domain and Valid until after uploading. An expired certificate's end date is highlighted and marked Expired.

When no certificate details are available, the panel displays You currently don't have an SSL certificate hosted in this Environment.

Replace or renew a certificate

Uploading a new SSL certificate overwrites the current certificate in the environment. You do not need to delete the current certificate first.

To replace a certificate, including one that has expired:

1. Open SSL Certificate in the environment settings.
2. Follow the upload procedure for your new certificate files.
3. After a successful upload, check Current SSL Certificate to confirm the new Domain and Valid until values.

Delete the current certificate

1. In SSL Certificate, select Delete Certificate beside Current SSL Certificate.
2. Review Delete SSL Certificate?.
3. Confirm the deletion.

warning

Once deleted, your domain or subdomain will no longer work in this environment. Deletion is permanent and cannot be undone.