1. Implementing Recruiting
  2. Enable Vanity URL

Enable Vanity URL

You can use a corporate vanity URL to allow external candidates to access external career sites. A vanity URL is a descriptive, pronounceable, truncated URL that also extends an organization’s brand.

When you enable the vanity URL feature, the vanity URL is used throughout the candidate journey in the career site, and in candidate facing communication. Once a vanity URL is set, it's used across all career sites.

Note: You must use a subdomain, such as https://jobs.vision.com, to use the vanity URL feature. Relative path URLs such as https://www.vision.com/careers aren't supported.

Here’s an example of how vanity URL works. Let’s say a company has the following web domain address: https//jobs.vision.com.

  • Candidates visit https://jobs.vision.com from their web browser.
  • The company web domain is controlled by the customer in the DNS provider’s website.
  • The company hosts a reverse proxy application or server in a cloud instance of their choice (outside of the Oracle HCM Cloud).
  • The company configures the DNS CNAME entry for the company’s web domain in the DNS provider’s website to point directly to the reverse proxy application.
  • Requests for https://jobs.vision.com are routed to the reverse proxy application.
  • The reverse proxy application forwards the client request to the actual Oracle HCM Cloud application host and relays the Oracle HCM Cloud application’s response back to the browser.

To enable a vanity URL, you need to:

  1. Enable Vanity URL
  2. Set Up CORS
  3. Host the Reverse Proxy Application at the Company’s Vanity Web Domain Address
  4. Review Third-Party Integrations Setup
  5. Review Features Not Supporting Vanity URL
  6. Test the Configuration

Enable Vanity URL

You need to enable the Vanity URL feature in the Setup and Maintenance work area.

  1. In the Setup and Maintenance work area, go to:

    • Offering: Recruiting and Candidate Experience

    • Functional Area: Recruiting and Candidate Experience Management

    • Task: Enterprise Recruiting and Candidate Experience Information

  2. Expand the Candidate Experience section and click Edit.

  3. Select the Vanity URL option.

  4. Enter the URL. Example: https://jobs.vision.com

    Select the Use search engine optimized setup option.

  5. Disable the Keep Me Signed In feature. You can't use a vanity URL if this feature is enabled.

  6. Click Save.

Set Up CORS

  1. In the Setup and Maintenance work area, click the Tasks icon.
  2. Click Search.
  3. Search for the task Manage Administrator Profile Values.
  4. Click the task name.
  5. On the Manage Administrator Profile Values page, search for the profile option code ORA_CORS_ORIGINS.
  6. Go to the Profile Values section.
    • If the Site row already exists, make sure to retain the existing value and append the Vanity URL domain to it.
    • If the Site row doesn’t exist, create a Site Row and assign the Vanity URL domain.
  7. Ensure the value “self” is part of the profile option value. Here’s an example.
    Syntax Example
    'self' <vanityURL> 'self' https://jobs.vision.com
    'self' <optional - existingURLValue> <vanityURL> 'self' https://abc.previousvalues.com https://jobs.vision.com
  8. Make sure to only enter the vanity URL domain or subdomain; don’t include any portion of the relative path. Example:

    If the vanity URL is https://jobs.vision.com, add https://jobs.vision.comand and https://vision.com to the profile option value.

  9. Search for the profile option CORS_ACCESS_CONTROL_ALLOW_HEADERS.
  10. Go to the Profile Values section.
  11. Append these values to existing profile option value: ora-irc-language, ora-irc-access-code, ora-irc-validation-mode, ora-irc-vanity-domain, ora-irc-cx-userid, ora-irc-oauth-token, ora-irc-cx-timestamp, ora-irc-rest-action
  12. Verify that you have entered the values exactly as specified. Make sure that there’s no extra blank space or missing hyphens.

  13. Click Save and Close.

Host the Reverse Proxy Application at the Company Vanity Domain

Work with your IT department to complete this step. A sample Vanity URL Reverse Proxy Script is available for you to use as a guide in the My Oracle Support document called Set Up Reverse Proxy Application for Vanity URL (Doc ID 3004743.1).

This reverse proxy application should be hosted on a cloud instance outside of the Oracle HCM Cloud. The DNS CNAME entry for the Company Vanity Domain in the DNS provider’s website must be configured to point to this reverse proxy application. Any request to the Company Vanity Domain will then be routed to the reverse proxy application. The reverse proxy application forwards the request to the actual Oracle HCM Cloud application host and relays the response back to the browser.

You must use subdomain such as https://jobs.vision.com to use the vanity URL feature. Relative path URLs such as https://www.vision.com/careers aren't supported.

Things to Consider When Switching to the Reverse Proxy Solution

If you used vanity URL prior to release 24A, you'll need to perform the following additional checks:
  • If you’re currently using a relative path Vanity URL (like https://www.vision.com/careers):
    • You need to use a new subdomain address (such as https://jobs.vision.com) as the Vanity URL while setting up the Reverse Proxy application. However, the links generated with relative path URLs prior to the switch will stop functioning.
    • To support the links generated prior to the switch, you'll need to continue hosting the static HTML at your current subdomain (for example: https://www.vision.com/careers). Within the static HTML, you can install a script to redirect the client request to the new Reverse Proxy Vanity URL address on load of the page. The Reverse Proxy Vanity URL address is hosted separately on a new and different sub-domain eg. https://jobs.vision.com/.
    • A sample script is available for you to use as a guide in the My Oracle Support document called Set Up Reverse Proxy Application for Vanity URL (Doc ID 3004743.1).
  • If you’re using subdomain format Vanity URL (like https://careers.vision.com) currently, then
    • The same subdomain can be used while setting up the Reverse Proxy application. However, the deep links that were generated prior to the reverse proxy setup switch will stop functioning as they are generated with hashtag (#) in the URL.
    • To support the links generated prior to the switch, you'll need to use a new and different subdomain (such as https://jobs.vision.com) while setting up the Reverse Proxy application. You'll also need to continue hosting the static HTML at your current subdomain (for example https://careers.vision.com). Within the static HTML, you can install a script to redirect the client request to the new Reverse Proxy Vanity URL address on load of the page.
    • A sample script is available for you to use as a guide in the My Oracle Support document called Set Up Reverse Proxy Application for Vanity URL (Doc ID 3004743.1).

Review Third Party Integrations Setup

If you enabled LinkedIn Profile Import, make sure to add the vanity domain.

  1. In the Setup and Maintenance work area, go to:

    • Offering: Recruiting and Candidate Experience

    • Functional Area: Recruiting and Candidate Experience Management

    • Task: Recruiting Category Provisioning and Configuration

  2. On the Category Provisioning and Configuration page, go to the Profile Import section and click Edit.

  3. On the Profile Import Partners page, go to the Social Media section and review the LinkedIn details. Make sure you entered an allowlisted URL for the vanity domain.

  4. Click Save.

Review Features Not Supporting Vanity URL

Review the list of features that don’t work with Vanity URL.

  • Keep me signed in: This feature isn’t compatible with the vanity URL feature. Turn off this feature if Vanity URL is enabled.
  • Career site links in site editor: All redirections from the editor to career sites or pages (for example, “Go To Site” link) won’t use the vanity URL; Fusion Application CE links will be used instead.
  • Job details page link copied from a requisition’s preview.

Test the Configuration

Test your configuration on a test or staging environment. Test all candidate facing use cases before enabling Vanity URL in production.

Related Topics