Set Up a Search Engine
Optimized Career Site Vanity
URL
May, , Version .
Copyright © , Oracle and/or its affiliates
Confidential – Oracle Restricted
Purpose statement
This document provides the setup steps to enable a search engine optimized career site Vanity URL solution.
Along with this document, there are sample scripts, referenced in this document, that are attached to the same
My Oracle Support (MOS) article. These sample scripts can be used to setup and enable Search Engine Optimized
Career Site Vanity URL solution.
Disclaimer
This document in any form, software or printed matter, contains proprietary information that is the exclusive
property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of
your Oracle software license and service agreement, which has been executed and with which you agree to
comply. This document and information contained herein may not be disclosed, copied, reproduced or
distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your
license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or
affiliates.
This document is for informational purposes only and is intended solely to assist you in planning for the
implementation and upgrade of the product features described. It is not a commitment to deliver any material,
code, or functionality, and should not be relied upon in making purchasing decisions. The development, release,
timing, and pricing of any features or functionality described in this document remains at the sole discretion of
Oracle. Due to the nature of the product architecture, it may not be possible to safely include all features
described in this document without risking significant destabilization of the code.
Set Up a Search Engine Optimized Career Site Vanity URL / Version .
Copyright © , Oracle and/or its affiliates / Confidential – Oracle Restricted
Table of contents
Overview
Solution
Serverless Compute Service Sample Function in Node.js
Steps to Enable Search Engine Optimized Vanity URL Solution
Things to Consider While Switching to Search Engine Optimized Vanity
URL Solution
Sample scripts for redirecting old Vanity URLs
References
List of figures
Figure . Serverless Compute Service Architecture
Figure . Career Site Request Flow
Figure . Search for task in Setup and Maintenance
Figure . Vanity URL Fields in the Candidate Experience Section
Set Up a Search Engine Optimized Career Site Vanity URL / Version .
Copyright © , Oracle and/or its affiliates / Confidential – Oracle Restricted
Overview
The Vanity URL feature allows a customer to map a custom domain (like https://jobs.vision.com) to their Fusion
Recruiting Candidate Experience, providing an alternative to the typical Oracle domain (for example:
https://edyy.fa.us2.oraclecloud.com/hcmUI/CandidateExperience).
The Vanity URL solution prior to 24A was not optimized for discoverability on search engines. Therefore, an
alternative architecture is now supported by the Oracle Recruiting Cloud to improve career site discoverability on
search engines. This is made possible with a compute instance that fronts the Fusion Application servers and
serves the initial career site content back to the client, requesting the career site. Notably, the vanity URL with the
enhanced solution will be free of the hashtag (#) character.
Solution
At its core, this solution architecture is a serverless compute service1 outside of Cloud HCM, that hosts a function
which forwards the request for the career site over to the Fusion Application instance. The Fusion Application
server responds back with the template career site HTML, which is relayed back to the client (Error! Reference
source not found.). Only the initial request for the career site is addressed to the serverless compute service; all
the subsequent requests for resources required to load the career site are fetched directly from the Fusion
Application server (Error! Reference source not found.).
Figure . Serverless Compute Service Architecture
The following setup is recommended for a simple, easy-to-set up, and auto-scaling infrastructure:
Host a Node.js function on a serverless compute service - For example: AWS Lambda, OCI Function,
Azure Function, etc. The function forwards the initial request for the career site resource to the Fusion
Application instance and responds back to the client. See the Serverless Compute Sample Function in
Node.js section for more details.
Create an Application Load Balancer - For example: AWS Elastic Load Balancer, Azure Load Balancer, OCI
Load Balancer with the cloud provider of choice for the Vanity Career Site Application2.
Add the newly created Application Load Balancer as the trigger for the Node.js function deployed on the
serverless compute service (For example: AWS Lambda, OCI Function, Azure Function, etc.). 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 3.
1
Using a serverless compute service is a simple, easy-to-setup and auto-scaling option. If other technologies & services are preferred, then they must be
independently explored and implemented by the customer.
2
Recommendation: create the application load balancer when configuring the function trigger in the next step. Instructions for AWS-
https://aws.amazon.com/blogs/networking-and-content-delivery/lambda-functions-as-targets-for-application-load-balancers/
3
The function trigger can be an API Gateway for the Vanity URL career site or an Edge Compute instance.
Set Up a Search Engine Optimized Career Site Vanity URL / Version .
Copyright © , Oracle and/or its affiliates / Confidential – Oracle Restricted
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. This is how it works:
Candidate requests for the customer’s career site hosted at the Vanity URL address.
The request reaches 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.
The other resources required to load the career site will be fetched directly from the Fusion
Application server, with only the initial request hitting the Vanity URL Application load balancer
and triggering the Node.js function to execute (Error! Reference source not found.).
Note: A serverless NodeJS compute service is a simple, easy-to-set up, and auto-scaling option. If other
technologies and services are preferred, then they must be independently explored and implemented by the
customer.
Figure . Career Site Request Flow
Serverless Compute Service Sample Function in Node.js
Use the file called ServerlessComputeFunctionNodeJS, attached to this same MOS article as a guide to define
the Node.js function serverless compute service. The file provided is a Node.js function that was written for AWS
Lambda. If using AWS Lambda for the Node.js function deployment, then the function provided in the script can
be copied over with the modifications as advised below 4.
The sample file is in .PDF format. Customers should follow the below steps to use the serverless compute service
Node.js function.
. Copy the contents of the PDF file into a text file and save it as .JS file.
. 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.
4
If not using AWS Lambda, then use this function as a guide for what needs to be running on a Compute instance.
Set Up a Search Engine Optimized Career Site Vanity URL / Version .
Copyright © , Oracle and/or its affiliates / Confidential – Oracle Restricted
Steps to Enable Search Engine Optimized Vanity URL Solution
Once the aforementioned setup is complete (Application Load Balancer setup to trigger the Node.js function
deployed on the serverless compute service, and the DNS configuration updated to map the vanity URL to the
Application Load Balancer), enable the search engine optimized Vanity URL for the career site:
. Access Setup and Maintenance.
. Click Tasks (document icon), and then click Search.
Figure . Search for task in Setup and Maintenance
. Search for the Enterprise Recruiting and Candidate Experience Information task.
. Click the task name.
. Expand the Candidate Experience section and click Edit.
. Select the Vanity URL option.
. Enter the URL. Example: https://jobs.vision.com.
. Select the Use search engine optimized setup option.
Figure . Vanity URL Fields in the Candidate Experience Section
Set Up a Search Engine Optimized Career Site Vanity URL / Version .
Copyright © , Oracle and/or its affiliates / Confidential – Oracle Restricted
. Disable the Keep Me Signed In feature. You can't use a vanity URL if this feature is enabled.
. Click Save.
Note: Similar to the previous HTML solution, customers need to set up CORS, review the third-party integrations
setup and the features not supporting Vanity URL. For more information, refer to the Enable Vanity URL topic in
Implementing Recruiting guide.
Things to Consider While Switching to Search Engine
Optimized Vanity URL Solution
If a customer already has an ORC supported Vanity URL setup, they need to consider below points while switching
to the new recommended setup.
The new setup supports only subdomain format Vanity URLs (like https://jobs.vision.com). Relative path
Vanity URLs (like https://www.vision.com/careers) aren’t supported.
Customers using relative path URL currently:
If customers are using relative path Vanity URL, then they need to use a new subdomain address (like
https://jobs.vision.com) as the Vanity URL while switching to the new recommended setup. However,
the links generated prior to the switch with relative path URL will stop functioning.
To support the links generated prior to the switch, customers need to continue hosting the static
HTML at the current relative path domain.
Write a script within the HTML to redirect the candidate/client request to the search engine
optimized Vanity URL address on load of the page. The file called
V1RelativePathVanityURL_Redirectto_V2SubDomainURL_Script, attached to this same MOS
article, contains sample script that you can use as a guide.
Note: Customers need to copy the contents of the
V1RelativePathVanityURL_Redirectto_V2SubDomainURL_Script.pdf file and save it as an HTML file
before using it.
Customers hosting the vanity site at their root domain/subdomain currently:
If customers are using the vanity URL with a subdomain such as https://careers.vision.com, then the
same subdomain can be used while switching to new recommended setup. However, the links that
were generated prior to the switch will stop functioning as they are generated with hashtag (#) in the
URL.
To support these links, customers need to add a custom JavaScript in the career site configuration
Theme tab.
Write a custom JavaScript to redirect the candidate/client request with hashtag URLs to the hashtag-
free Vanity URL address on load of the page. The file called
SubDomainVanityURLReuse_RedirectV1ToV2_CustomJavaScript, attached to this same MOS
article, contains sample script that you can use as a guide.
Note: Generally, vanity site points to the highest order career site (first site with Active status in the Career
Site Configuration page). If it is pointed to any other site, then the custom JavaScript should be added to
both the highest order site and the vanity site.
Sample scripts for redirecting old Vanity URLs
Customers using relative path URL currently:
Use the file called V1RelativePathVanityURL_Redirectto_V2SubDomainURL_Script, attached to
this same MOS article, as a guide to help you redirect the candidate/client requests.
Set Up a Search Engine Optimized Career Site Vanity URL / Version .
Copyright © , Oracle and/or its affiliates / Confidential – Oracle Restricted
The script is designed to run on page load.
It takes the relative path Vanity URL with hashtag as the input, generates a new URL by replacing the
URL component before hashtag, with the new Vanity URL subdomain address and removes the
hashtag. This new URL requested hits the Application load balancer that triggers the Node.js function
deployed on a serverless container, which then relays the career site template having fetched it from
the Fusion Applications instance back to the requesting client.
The sample file is in .PDF format. Customers should follow the below steps to use the script.
o Copy the contents of the file into the current HTML file that is hosted at their root domain by
replacing the existing content.
o Add the company’s vanity URL for vanityAppUrl variable as instructed in the script and
save it as .HTML file.
Customers hosting the vanity site at their root domain/subdomain currently:
Use the file called SubDomainVanityURLReuse_RedirectV1ToV2_CustomJavaScript, attached to
this same MOS article, as a guide to help you redirect the candidate/client requests.
The script is designed to run on page load.
It takes the root domain/subdomain Vanity URL with hashtag as the input and generates a URL by
removing the hashtag. This new URL requested hits the Application load balancer that triggers the
Node.js function deployed on a serverless container, which then relays the career site template
having fetched it from the Fusion Applications instance back to the requesting client.
The sample file is in .PDF format. Customers should follow the below steps to use the script.
o Access Setup and Maintenance.
o Click Tasks (document icon), and then click Search.
o Search for the Candidate Experience task.
o Click Career Sites Configuration.
o Click on Settings/Gear icon next to a site. Generally, vanity site points to the highest order
career site (first site with Active status in the Career Site Configuration page). If it is pointed
to any other site, then the custom JavaScript should be added to both the highest order site
and the vanity site.
o Click Edit.
o Click Theme tab.
o Expand Custom JavaScript section.
o Copy the contents of the sample script PDF file and paste it in the Custom JavaScript section.
o Click Apply Changes.
o Click Publish site.
References
Enable Vanity URL topic in Implementing Recruiting guide
Set Up a Search Engine Optimized Career Site Vanity URL / Version .
Copyright © , Oracle and/or its affiliates / Confidential – Oracle Restricted
Connect with us
Call + . .ORACLE or visit oracle.com. Outside North America, find your local office at: oracle.com/contact.
blogs.oracle.com facebook.com/oracle twitter.com/oracle
Copyright © , Oracle and/or its affiliates. This document is provided for information purposes only, and the contents hereof are subject to change without notice. This document
is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of
merchantability or fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are formed either directly or
indirectly by this document. This document may not be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without our prior written
permission.
Oracle, Java, MySQL, and NetSuite are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Set Up a Search Engine Optimized Career Site Vanity URL / Version .
Copyright © , Oracle and/or its affiliates / Confidential – Oracle Restricted
