Vanity URL New Solution

The Vanity URL feature now works with reverse proxy setup, which is designed to replace the current HTML solution. By implementing a reverse proxy, you can enhance a website's performance, reliability, and security, along with hashtag (#) free Vanity URLs which, in turn, can positively impact the search engine rankings. This reverse proxy script should be hosted in a cloud instance outside of the Oracle HCM Cloud. When a candidate visits the vanity URL, the reverse proxy script forwards the request to the actual Oracle HCM Cloud application host and relays the Oracle HCM Cloud application’s response back to the browser.

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.

With this feature, you can enhance your corporate branding and create a seamless candidate experience from a corporate site through the career site and application process.

Steps to Enable

By default, Vanity URL isn’t available to customers. You can set up only one Vanity URL for your organization. The Vanity URL will be used for all career sites.

To enable a Vanity URL, you need to follow these steps:

  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 That Don't Support Vanity URL
  6. Test the Configuration

1. 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
  1. Expand the Candidate Experience section and click Edit.
  2. Select the option, Vanity URL.
  3. Enter the URL. Example: https://jobs.vision.com
  4. Select the Use reverse proxy 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.

2. 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.
  1. Ensure the value “self” is part of the profile option value. Here’s an example.

Example of the Self Value

Example of the Self Value

Syntax

Example

'self' <vanityURL>

'self' https://jobs.vision.com

'self' <optional - existingURLValue> <vanityURL>

'self' https://abc.previousvalues.com https://jobs.vision.com
  1. 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 subdomain is https://jobs.vision.com, add https://jobs.vision.comand and https://vision.com to the profile option value.
  2. Search for the profile option CORS_ACCESS_CONTROL_ALLOW_HEADERS.
  3. Go to the Profile Values section.
  4. 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
  5. Verify that you have entered the values exactly as specified. Make sure that there’s no extra blank space or missing hyphens.
  6. Click Save and Close.

3. Host the Reverse Proxy Application at the Company's Vanity Domain Address

Work with your IT department to complete this step. You can refer to the ReverseProxySetupScript sample script as a guidance. For details, refer to the document called Set Up Reverse Proxy Application for Vanity URL on My Oracle Support.

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.

4. 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
  1. On the Category Provisioning and Configuration page, go to the Profile Import section and click Edit.
  2. 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.
  3. Click Save.

5. Review Features That Don't Support 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.

6. Test the Configuration

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

Tips And Considerations

  • 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.

Key Resources

  • If you used the vanity URL feature prior to 24A, you'll need to switch from the HTML solution to the reverse proxy setup. For instructions on how to do this, refer to the Enable Vanity URL topic in the Implementing Recruiting guide on Oracle Help Center.
  • Refer to the article on My Oracle Support called Set Up Reverse Proxy Application for Vanity URL (DOC ID 3004743.1) for additional configuration information.