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.

  • The company hosts a Node.js function on a serverless compute service and creates an Application Load Balancer with the cloud provider of choice for the Vanity Career Site Application.
  • Adds the newly created Application Load Balancer as the trigger for the Node.js function deployed on the serverless compute service. The trigger for the Node.js function is an incoming request to either the Vanity Career Site Application’s API Gateway, Application Load Balancer, or a CDN/edge compute for your Vanity Career Site Application.
  • Create a DNS record that maps the company’s vanity address to the IP or canonical name (CNAME) for the Application Load Balancer that triggers the Node.js function. Any request to the company’s vanity career site will then trigger the Node.js function to execute.
  • Now when the candidates visit https://jobs.vision.com from their web browser, requests for https://jobs.vision.com are routed to the Application Load Balancer which triggers Node.js function deployed on the serverless compute service.
  • The Node.js function containing the actual Fusion Application URL will forward the request to the Fusion Application host.
  • The Fusion Application server will then respond back with the career site HTML.
  • The Node.js function will relay the response from Fusion Application server to the candidate’s browser.
Note: The initial request to fetch the career site will hit the Vanity URL application load balancer that triggers the Node.js function. Other resources are directly loaded from the Fusion applications instance from the client browser without going via the load balancer.

To enable a vanity URL, you need to:

  1. Host Node.js function on a serverless compute service.
  2. Set Up CORS.
  3. Enable Vanity URL.
  4. Review Third-Party Integrations Setup.
  5. Review Features Not Supporting Vanity URL.
  6. Test the Configuration.

Host Node.js Function on a Serverless Compute Service

Work with your IT department to complete this step.
  • Host a Node.js function on a serverless compute service. (Examples include AWS Lambda, OCI Function, or Azure Function). This function forwards the initial request for the career site resource to the Fusion Application instance and responds back to the client.
  • A sample Node.js function is available for you to use as a guide in the My Oracle Support document called Set Up Search Engine Optimized Career Site Vanity URL (Doc ID 3004743.1). Update the script with your Fusion Applications URL and Vanity URL as instructed in the sample file. After updating the function with the required URLs, add it to run on the Node.js serverless compute instance.
  • Create an Application Load Balancer with the cloud provider of choice for the Vanity Career Site Application. (Examples include AWS Elastic Load Balancer, Azure Load Balancer, and OCI Load Balancer.)
  • Add the newly created Application Load Balancer as the trigger for the Node.js function deployed on the serverless compute service. The trigger for the Node.js function is an incoming request to either the Vanity Career Site Application’s API Gateway, Application Load Balancer, or a CDN/edge compute for your Vanity Career Site Application.
  • Create a DNS record that maps the company’s vanity address to the IP or canonical name (CNAME) for the Application Load Balancer that triggers the Node.js function. Any request to the company’s vanity career site will then trigger the Node.js function to execute.
  • The serverless compute service hosting the Node.js function fronts the Fusion application instance where the career site content will be fetched from.

    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 While Switching to Search Engine Optimized Vanity URL Solution

If you used vanity URL before 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 switching to the new recommended search engine optimized solution. However, the links generated with relative path URLs before the switch will stop functioning.
    • To support the links generated before 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 Vanity URL address used for the search engine optimized solution 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 Search Engine Optimized Career Site Vanity URL (Doc ID 3004743.1).
  • If you’re hosting the vanity site at your root domain or subdomain (like https://careers.vision.com) currently, then:
    • The same subdomain can be used while switching to the new search engine optimized solution. However, the deep links that were generated before the switch will stop functioning as they're generated with hashtag (#) in the URL.
    • To support these links, you need to add a custom JavaScript in the career site configuration Theme tab that will redirect the candidate/client request with hashtag URLs to the hashtag free Vanity URL address on load of the page.
    • A sample custom JavaScript is available for you to use as a guide in the My Oracle Support document called Set Up Search Engine Optimized Career Site Vanity URL (Doc ID 3004743.1).
    Note: Generally, the vanity site points to the highest order career site (the first site with Active status on the Career Site Configuration page). If it's pointed to any other site, then the custom JavaScript should be added to both the highest order site and the vanity site.

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 part 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've entered the values exactly as specified. Make sure that there’s no extra blank space or missing hyphens.

  13. Click Save and Close.

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.

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. The URLs must be in the format https://<company_vanity_hostname> for the vanity domain.

  4. Click Save.

    Note: If you enabled Apply with Indeed then you need to configure the redirection URL with vanity domain like https://<company_vanity_hostname>/profileImport/oauth . For example, https://jobs.vision.com/profileImport/oauth.

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