Business / Technical Brief

Oracle Recruiting Cloud

Enable Vanity URL

August 9, 2021, Version 2.1

Copyright © 2021, Oracle and/or its affiliates
Public

1 Oracle Recruiting Cloud – Enable Vanity URL / Version 2.1

Copyright © 2021, Oracle and/or its affiliates / Public
Purpose statement
This document provides an overview of features and enhancements included in
release 21B. It is intended solely to help you assess the business benefits of
upgrading to 21B and to plan your I.T. projects.

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, and timing 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.

Note: In the images or examples included in this document regarding: user

details, company names, addresses, emails, and/or telephone numbers
represent a fictitious sample of data (based upon made up data used in a
demo environment). Any similarity to actual persons, living or dead, is
purely coincidental and not intended in any manner.

2 Oracle Recruiting Cloud – Enable Vanity URL / Version 2.1

Copyright © 2021, Oracle and/or its affiliates / Public
Table of Contents

Purpose statement .................................................................................................................................................. 2

Disclaimer ................................................................................................................................................................. 2

Controlled Availability Feature .............................................................................................................................. 4

Enable Vanity URL for Oracle Recruiting Cloud.................................................................................................... 4

How it Works? ........................................................................................................................................................... 4

Steps to Enable......................................................................................................................................................... 5
Step 1: Create a Profile Option ................................................................................................................................................5
Step 2: Enable Vanity URL ........................................................................................................................................................5
Step 3: Set Up CORS ..................................................................................................................................................................5
Step 4: Add HTML to Your Website ........................................................................................................................................6
Step 5: Review 3rd Party Integrations Setup ........................................................................................................................6
Step 6: Review Features Not Supporting Vanity URL .........................................................................................................6
Step 7: Testing Strategy Recommendation ..........................................................................................................................7

Known Issues and Fixes........................................................................................................................................... 7

3 Oracle Recruiting Cloud – Enable Vanity URL / Version 2.1

Copyright © 2021, Oracle and/or its affiliates / Public
Controlled Availability Feature
Vanity URL is a Controlled Availability feature. Only customers approved by Oracle can use this document.

Enable Vanity URL for Oracle Recruiting Cloud

This document covers how to set up Vanity URL for Oracle Recruiting Cloud. You can use a vanity domain, sub-
domain, or path-based domain to access external career sites. When the feature is enabled, a Vanity URL will be used
in the candidate journey in the career site and in candidate facing communication.

How it Works?

Step 1: Candidate visits https://jobs.vision.com or https://www.vision.com/jobs from their web browser.

Step 2: The company web domain address is controlled by the customer, and the customer’s website sends the initial
request. The company’s web server or content server responds to this request with static HTML content. A sample of
the HTML content that should be returned is provided with the instructions and referenced in Step 4 of the “Steps to
Enable” section.

Step 3: The HTML returned in Step 2 contains javascript that instructs the browser to load the career site application
from Oracle HCM Cloud.

Step 4: The javascript code replaces the browser content with the career site application from Oracle HCM cloud. All
subsequent actions from the career site are directly routed to Oracle HCM cloud via REST service calls.

4 Oracle Recruiting Cloud – Enable Vanity URL / Version 2.1

Copyright © 2021, Oracle and/or its affiliates / Public
Steps to Enable
By default, the Vanity URL feature isn’t available to customers. Customers need to create a profile option to
enable the Vanity URL support feature.

Only one Vanity URL can be set up, it will be used for all career sites.

Step 1: Create a Profile Option

1. You need to add the new profile option IRC_VANITY_URL_ENABLED:
• Create the option using the "Manage Profile Options" setup task.
• Set only "Site" level as "Enabled" and "Updatable".
2. Option value (Y) to be set using "Manage Administrator Profile Values" setup task.
PROFILE OPTION VALUE IS SEEDED?

IRC_VANITY_URL_ENABLED Y (Site Level) Not seeded

Step 2: Enable Vanity URL

You need to use the "Enterprise Recruiting and Candidate Experience Management" setup task to define the
vanity URL:

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. In the Corporate Branding section, select Active for the Vanity URL option.
3. Add your URL.
4. Make sure the "Keep Me Signed In" feature is disabled . Vanity URL can’t be used if this feature is
enabled.

Step 3: Set Up CORS

1. Navigate to the Task Manage Administrator Profile Values.
2. Search for the profile option ORACLE.ADF.VIEW.ALLOWED_ORIGINS.
a. 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.
b. Ensure the value “self” is part of the profile option value. Example:
Syntax:

'self' <vanityURL>

5 Oracle Recruiting Cloud – Enable Vanity URL / Version 2.1

Copyright © 2021, Oracle and/or its affiliates / Public
 'self' <optional - existingURLValue> <vanityURL>

Example:

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

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

Make sure to only enter the vanity URL domain or sub-domain, do not include any portion of the
relative path. For example, if your vanity URL domain is a separate sub-domain such
as https://jobs.vision.com, add https://jobs.vision.com and https://vision.com to the profile option
value. If your vanity URL domain includes a relative path such as https://www.vision.com/jobs,
add https://www.vision.com & https://vision.com to the profile option value.

3. Search for the profile option CORS_ACCESS_CONTROL_ALLOW_HEADERS. 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
Verify that you have entered the values exactly as specified and there’s no extra white space or
missing hyphens.

Step 4: Add HTML to Your Website

You should work with your IT department to complete this step.

You can use the HTML sample in the Vanity URL HTML.html file as a guidance.

You can use a domain such as www.visionjobs.com or a sub-domain such as jobs.vision.com to host the external
career site. In this case, place the HTML in your website’s root index page.

Alternatively, you can use a path-based domain such as careers.vision.com/jobs. This setup is appropriate when
you have an existing career site that hosts your recruiting marketing content, and you can set up a relative path
(/jobs) to host the jobs from the candidate experience site. In this case, place the HTML in the index page of your
career website's relative path.

Make sure to replace the <<FUSION_CE_HOST_ADDRESS>> token used in the sample file, with CE host address
in the html.

Do not create a DNS CNAME entry pointing your domain / subdomain to Oracle’s Fusion Applications domain –
this is not supported.

Step 5: Review 3rd Party Integrations Setup

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

Step 6: Review Features Not Supporting Vanity URL

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

— Site preview on social media

6 Oracle Recruiting Cloud – Enable Vanity URL / Version 2.1

Copyright © 2021, Oracle and/or its affiliates / Public
 The open graph tags will not be recognized when your site uses Vanity URL. Instead, you should add
static open graph meta tags in the static html. For example, adding the following meta tags will result in
the social media sites (such as LinkedIn or Facebook) to use the title, description, and image in the job
posting link preview.

<meta property="og:title" content=“Vision Careers">

<meta property="og:description" content=“Explore exciting jobs at Vision">

<meta property="og:image" content="http://careers.vision.com/thumbnail.jpg">

<meta name="twitter:card" content="summary_large_image">

— Keep me signed in

This feature is not compatible with the Vanity URL feature. You should turn off this feature if Vanity URL
is enabled.

— Candidate Experience links in site editor

All redirections from the editor to Candidate Experience sites or pages (for example, “Go To Site” link)
will not use the Vanity URL, Fusion Application CE links will be used instead.

Step 7: Testing Strategy Recommendation

Test your configuration on a test/staging environment and exercise all candidate facing use cases before
enabling Vanity URL on production.

Known Issues and Fixes

Issue Description:
When Vanity URL is enabled, a request from a user's browser (only in Chrome and Microsoft Edge) occasionally
times out which results in the user not able to view a page or complete an action. Once a particular request has
timed out, all subsequent attempts for the same request from the same browser will time out. This timeout issue
doesn’t impact other users or the same user using a different browser to view the page or complete the action in
the career site.

Fix:
While this problem is a browser-specific issue and may only occur on rare occasions, we advise all customers
using the Vanity URL feature to enable the profile option ORA_IRC_CE_VTURL_ADD_TIMESTAMP_HEADER with
the value set to Y. By setting this profile option, all browser requests to Oracle Recruiting will include a request
header with the current system time, which prevents the browser requests from timing out.

7 Oracle Recruiting Cloud – Enable Vanity URL / Version 2.1

Copyright © 2021, Oracle and/or its affiliates / Public
Connect with us

Call +1.800.ORACLE1 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 © 2021, Oracle and/or its affiliates. All rights reserved. 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 and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of
SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered
trademark of The Open Group. 0120

8 Oracle Recruiting Cloud – Enable Vanity URL / Version 2.1

Copyright © 2021, Oracle and/or its affiliates / Public