--- title: "Apps" slug: "apps" updated: 2024-09-20T14:20:21Z published: 2024-09-20T14:20:21Z canonical: "documentation.infinite.com/apps" --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.infinite.com/llms.txt > Use this file to discover all available pages before exploring further. # Apps ### Create Facebook App Abstract **Facebook** - Contact your organizations Infinite representative before the Facebook API keys are updated as the candidate experience might be impacted by the update. - When candidates log in to Talent Gateways by using the **Sign In with Facebook** option, a unique ID is created and mapped, and their Talent Gateway account is connected to their Facebook profile. For these candidates to continue logging in to the Talent Gateway by using their Facebook profile, this unique ID must not change. - If the API keys are updated in Workbench, the candidates that were accessing the Talent Gateways with their Facebook profile are not able to view their previous job submissions. This is because a new unique ID is created for the new API key. - If the API key is updated, Facebook returns a different Unique-ID for the same Facebook credentials. The Infinite Talent Gateway creates a new account for that profile instead of logging the candidate into the old profile, as the mapping for this new Unique-ID cannot be found. - There are two options for resolution: - Revert to the Old API keys, so that the old candidates who logged-in before the new API keys were updated, can safely log in to their profile. This can affect the candidates who logged-in after the new API keys update. - Leave the new API keys as it is and ask the candidates (who submitted with old API keys) to log in to the Talent Gateway and update their profile in the profile page (candidate zone) with the same details as before. This stacks their profiles with the previous talent record in BrassRing. After it is stacked, they can see the previously submitted applications in the TG. - The process on this page shows the process on a third-party website. This website and process is subject to change without notification. Infinite is not responsible for the content on third-party websites. #### Process 1. Login to your Facebook account and scroll down to the bottom, where there are hyperlinks displayed as shown in the following figure. Select **Developers**. ![FBimage1.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/613cd3dd-11da-4339-9a4b-b77467dbf04e.jpg) 2. Select Apps → Register as a Developer. If you are already a registered developer, **Create a New App** is displayed, move to step 7 ![FBimage2.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/e18ab419-bfde-4ff5-97f6-ba3b6fd059d7.jpg) 3. Enter your **Facebook password** for confirmation if it is requested. 4. A pop up **Register as a Facebook Developer** is displayed. select **YES**to accept the policy and then select **Next**. ![FBimage3.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/c4eeb22a-bf69-4c6b-9eda-e0aa01a8c426.jpg) 5. To verify your account, phone number is requested. A code is sent to this phone number for confirmation. The entered number is added to your timeline but would not be visible to your friends. ![FBimage4.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/8a1efa10-8ec4-41bf-821b-88fdbce245a5.jpg) 6. After successful registration, a pop up is displayed. Select Done. ![FBimage5.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/fdd47eae-6e6a-49fd-9687-6f0f3e1bf35d.jpg) 7. Select Go to Apps → Create a New App. ![FBimage6.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/d29bed6c-8571-4a9e-bb22-8978f7a8e68e.jpg) 8. Enter the **App details** as stated below: ![FBimage7.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/675624a7-0818-4d78-ade2-4857124381bc.jpg) 9. For security check, enter **the text**that is displayed on the screen in the text box and select **Submit**. ![FBimage8.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/582595f7-6bdb-445c-a41a-e0c761236021.jpg) 10. App is created with the **Display Name**. ![FBimage9.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/cf9fcfe7-ad14-488e-91bb-90dd88156dc9.jpg) 11. Select **Show**, to view the **Secret Key.** 12. You are requested to re-enter your Facebook password for security. Enter **the password** and select **Submit**. ![FBimage10.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/79e01bb0-62e9-4d75-a1d3-3688fced6bf6.jpg) 13. **Secret Key**is now displayed on the screen. ![FBimage11.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/d902dcc6-ca24-4f74-ad01-c5d98fdbbdea.jpg) 14. Select the **Settings tab**, select the **Basic Settings** tab and select **Add Platform**. ![FBimage12.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/59e96720-56c4-4862-a4b6-cf6adf59cc6e.jpg) 15. In the Select platform pop up, select **Website**. ![FBimage13.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/b2589afd-ca1d-483d-924c-d77dfab50ccc.jpg) 16. In the Basic tab, enter the appropriate **URL**in the Site URL field, depending on the BrassRing environment your organization/client is creating this app for. ![FBimage14.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/86077874-b7e9-4841-8361-c96eefac30b5.jpg) - US Production: [https://sjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx](https://sjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx) - US Staging: [https://sstagingjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx](https://sstagingjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx) - EU Production: [https://krb-sjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx](https://krb-sjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx) - EU Staging: [https://stagingkrb-sjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx](https://stagingkrb-sjobs.brassring.com/TGWebHost/SocialMediaIntegration.aspx) 17. In the **Advanced tab**, under the Security section, select **YES**for the highlighted fields in the following figure. All other fields can be left as they are with the default values. ![FBimage15.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/0fe2295c-f92c-49e1-8227-9695613364f6.jpg) 18. Select **App Details** tab to update your company details. ![FBimage16.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/fb335fff-743a-4bbb-83ab-9dd6f0b0fc89.jpg) ![FBimage17.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/a714a2ef-3b38-467b-98f4-dbb177fd799e.jpg) 19. Select **Status & Review** tab. 20. Select **YES**for the query **Do you want to make this app and all its live features available to the general public?** 21. Select **Confirm**. ![FBimage18.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/10f64ddf-8392-4272-90c8-ce7773ac7bb2.jpg) 22. In Workbench, open **Facebook's Administer configuration** page and insert the **App ID**and **App Secret.** ![FBimage19.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/065b1786-8ca8-4d8a-b90c-f8ff8c893822.jpg) 23. You may choose to use one API key and Secret Key pair for all three combinations, but it is a best practice to create three different pairs. The advantage of creating your own Facebook app is that, candidates and users see client's brand instead of BrassRing's brand on the authorization screen. ![FBimage20.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/6a09dece-67c5-4fe8-9fe2-efce0a9a3a8f.jpg) ### Create a LinkedIn App Abstract Product: **BrassRing** - BrassRing is partnered with LinkedIn and allows clients to create Apps with LinkedIn to configure: - Posting to LinkedIn - Sign In with LinkedIn and Sign In with LinkedIn using OpenID Connect - Contact your organizations Infinite representative before the LinkedIn API keys are updated as the candidate experience might be impacted by the update. - When candidates log in to Talent Gateways by using the **Sign In with LinkedIn**, a unique ID is created and mapped, and their Talent Gateway account is connected to their LinkedIn profile. For these candidates to continue logging in to the Talent Gateway by using their LinkedIn profile, this unique ID must not change. - If the API keys are updated in Workbench, the candidates that were accessing the Talent Gateways with their LinkedIn profile are not able to view their previous job submissions. This is because a new unique ID is created for the new API key. - If the API key is updated, LinkedIn returns a different Unique-ID for the same LinkedIn credentials. The Infinite Talent Gateway creates a new account for that profile instead of logging the candidate into the old profile, as the mapping for this new Unique-ID cannot be found. - There are two options for resolution: - Revert to the Old API keys, so that the old candidates who logged-in before the new API keys were updated, can safely log in to their profile. This can affect the candidates who logged-in after the new API keys update. - Leave the new API keys as it is and ask the candidates (who submitted with old API keys) to log in to the Talent Gateway and update their profile in the profile page (candidate zone) with the same details as before. This stacks their profiles with the previous talent record in BrassRing. After it is stacked, they can see the previously submitted applications in the TG. - The process on this page shows the process on a third-party website. This website and process is subject to change without notification. Infinite is not responsible for the content on third-party websites. #### Process #### Create a LinkedIn App 1. Access [https://developer.linkedin.com](https://developer.linkedin.com). 2. Select **Create app.** 3. Sign in by using your account credentials. 4. Select **Create app.** | ![image049.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/11d9c701-f6b1-4211-af53-f6c80331a445.jpg) | | --- | 5. Complete the form with as much detail as possible and select Create app. Table 17. Application Details required to create a LinkedIn App | S. No | Field Name | Required | Description | | --- | --- | --- | --- | | 1 | Company Name | Yes | Your Company Name | | 2 | Name | Yes | Name of the Application. Example: Infinite Talent BrassRing EU Staging | | 3 | Description | Yes | Your App Description | | 4 | Application Logo URL | Yes | Your company or product Logo URL | | 5 | Website URL | Yes | e-mail address of the App owner | | 6 | Business E-mail | Yes | Phone number of the App owner | | 7 | Business Phone | Yes | Update the appropriate URL from the URL table given at the end of this document | | 8 | OAuth 2.0 Authorized Redirect URLS | No | | | 9 | OAuth 1.0a Default "Accept" Redirect URL | No | | | 10 | OAuth 1.0a Default "Cancel" Redirect URL | No | | ![image050.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/a7994abb-32d2-4e47-a880-2a2b03260f2b.jpg) 6. Select the **Redirect URLs pencil icon**. | ![image051.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/ce723273-348f-46ae-a120-f3d434661970.jpg) | | --- | 7. Select **+ Add redirect URL.** ![RedirectURL](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/RedirectURL.png) 8. Insert the redirect URLs from the table as needed. - Ensure that there are no spaces after the URLs. - The URLs are case-sensitive and must be entered exactly as specified. - **Table 18. Redirect URL List** | Domain | Type | Redirect URLs | | --- | --- | --- | | US Production | Akami | - https://sjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | | US Production | SSL | - https://sjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | | US Production | Vanity | - Client set Vanity URL/tgwebhost/SocialMediaIntegration.aspx | | Staging | Akami | - https://sstagingjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | | Staging | SSL | - https://sstagingjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | | Staging | Vanity | - Client set vanity URL/tgwebhost/SocialMediaIntegration.aspx | | EU Production | Akami | - https://krb-sjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | | EU Production | SSL | - https://krb-sjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | | EU Production | Vanity | - Client set vanity URL/tgwebhost/SocialMediaIntegration.aspx | 9. Select Update. 10. A confirmation message, the API, and secret keys, is displayed. The App that is created is now listed in the **My Apps** tab. Select the app to view and edit the app settings. 11. ![ProductList](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/ProductList.png) Upon creation of the App, select **Request access** for **Sign In With LinkedIn using OpenID Connect** and **Share on LinkedIn** from the **Products** list. 12. For the Clients with existing keys, add the product **Sign In With LinkedIn using OpenID Connect**from the Products list. #### Workbench Configuration 1. In Workbench select Tools → Settings → Social Media Configuration. 2. Select the **LinkedIn Administer configuration icon.** 3. Insert the **API Keys**and **Secret Keys.** 1. If your organization is using more than one workflow of LinkedIn integration, it is recommended to create three separate APIs. One API key and Secret Key pair can be used for all three combinations, but it is a best practice to create three different pairs. 1. The first API key is used for BrassRing workflows, or posting to company or individual accounts from within BrassRing. 2. The second API key is used for Talent Gateway workflows for logged in users. 3. The third API key is used for Talent Gateway users who have not logged in. ![image053.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/e8080826-29c7-46af-9442-7d3b15f1e207.jpg) 4. Select **Save**. ### Create a Twitter API Please select an appropriate access plan as shown while creating the App. ![Twitter_access1.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/a2266866-d202-4e9e-a20a-bce5f8547070.png) ![Twitter_access.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/04101180-3fa7-4423-be36-db3290c2bc66.png) - Contact your organization's Infinite representative before the Twitter API keys are updated as the candidate experience might be impacted by the update. - When candidates log in to Talent Gateways by using the **Sign In with Twitter** option, a unique ID is created and mapped, and their Talent Gateway account is connected to their Twitter profile. For these candidates to continue logging in to the Talent Gateway by using their Twitter profile, this unique ID must not change. - If the API keys are updated in Workbench, the candidates that were accessing the Talent Gateways with their Twitter profile are not able to view their previous job submissions. This is because a new unique ID is created for the new API key. - If the API key is updated, Twitter returns a different Unique ID for the same Twitter credentials. The Infinite Talent Gateway creates a new account for that profile instead of logging the candidate into the old profile, as the mapping for this new Unique ID cannot be found. - There are two options for resolution: - Revert to the old API keys, so that the old candidates who logged in before the new API keys were updated, can safely log in to their profile. This can affect the candidates who log in after the new API keys update. - Leave the new API keys as it is and ask the candidates (who submitted with old API keys) to log in to the Talent Gateway and update their profile on the profile page (candidate zone) with the same details as before. This stacks their profiles with the previous talent record in BrassRing. After it is stacked, they can see the previously submitted applications in the Talent Gateway. - The process on this page shows the process on a third-party website. This website and process are subject to change without notification. Infinite is not responsible for the content on third-party websites. #### How to Create Twitter API This task outlines the procedure to create a Twitter API and the configuration of the Secret Key that is obtained in the process. #### Process 1. Open the developer site for Twitter [https://developer.twitter.com/](https://developer.twitter.com/en). Create a new developer account. ![The sign-in option](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/ff8da32e-9ee5-4089-9bb0-cc53c097bbc1.jpg) 2. Provide your Twitter account details. ![Complete all fields with appropriate information](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/e21a0869-e4e7-450a-9c43-5883018d0c1e.jpg) 3. Insert the details on the application form. ![Developer Portal](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/ad8171d6-a575-4f16-a508-4515c70af4c3.jpg) 4. Read and agree to the terms and conditions. Select**Accept Terms & Conditions**. Select **Submit**. ![The terms and conditions page](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/9503aadb-1ff7-4030-a2e3-fe4caacd3fe5.jpg) 5. Add a name to your Twitter app, and set up your company's icon. ![twapp_4.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/c9e67a2b-772a-4641-859b-5265443ae86d.jpg) 6. Your app is successfully created and the API key is displayed as shown in the following image. 7. **Copy and store the keys on a local file. They are not visible after this step. These keys must be entered in Workbench > Social Media Integration > Twitter** > [!NOTE] > Note > > The keys displayed in the following image are for guidance only. Create a new set of keys for your company's use. ![Store the keys](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/20784421-7f3c-41b4-b33c-c72e11474aee.jpg) 8. The next screen displays a reminder to save the secret keys. ![twapp_6.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/f8924c4b-e3d4-45e9-b7d6-279fae438393.jpg) 9. The next step is to set up the user authentication settings. Select **Set up**. ![twapp_7.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/4e3d256a-52d7-447a-94fc-cb40158ab40d.jpg) 10. Select the **App permissions** and **Type of App** in the user authentication settings. ![twapp_8.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/15bf16b1-41d2-4b26-bf5b-8b567d030617.jpg) 11. In the next screen, add the Callback URI and Redirect URLs accurately. Refer to the [table](/docs/apps#uriurl-table) at the end of the page for URI/URLs. > [!NOTE] > Your title goes here > > - Website URL = Client's Talent Gateway URL > - Organization Name = Client Name > - The callback URI must be named as per the BrassRing environment. ![twapp_9.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/a7bb4c08-d97e-4994-b462-96871b773804.jpg) 12. Now the Twitter app is created and it has essential access. The next step is to apply for elevated access from the product to V2. Select **Apply**. ![twapp_10.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/a5da9b35-d3bf-41ab-8fc8-b10e5401f0ba.jpg) 13. Enter appropriate information in the Basic Info section. While adding information, it is better to add a team profile, so that more than one employee of the organization has access to this app account. ![twapp_13.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/19bbf277-84c1-4619-b30d-7f1ec126ea17.jpg) 14. In the next step, enter information about the intended use of this app. Provide a description in over 200 words explaining what is the purpose of this app. > [!NOTE] > Note > > **Sample description:***This Twitter app and the keys enable our company's job applicants to log in to the company's career sites using their Twitter login credentials. They also allow our candidates to tweet the jobs posted on our careers site to their respective Twitter accounts.* ![twapp_11.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/969153b6-41b3-4726-94e0-b0c4332e13ce.jpg) 15. Intended Use section continued - Choose **No** for all the specific options. ![twapp_12.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/24549bfd-31b3-4c9b-bae1-d73e6fff5751.jpg) 16. Verify that your project displays the V1.1 access. ![twapp_14.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/14b06d19-2128-47d2-9cb1-8a92f3a771a6.jpg) 17. Review all the information for Elevated access. ![twapp_16.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/7ca30f1e-1abe-4ead-91f3-d29b7547c274.jpg) 18. In the next step, use add app option at the project level to create apps for staging and production environments separately. ![twapp_15.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/ad8e0719-cb8f-4cbc-8705-09e8bef631d1.jpg) 19. The API Key and Secret key must be provided in Workbench on Twitter's**Administer configuration**page as follows: ![The API keys](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/c88b6a1b-9f6b-4ea5-95e4-0c801fe0e611.jpg) 20. You might choose to use one API key and Secret Key pair for all three combinations, but it is a good practice to create three different pairs. The advantage of creating your own Twitter app is that candidates and users see the client's brand instead of BrassRing's brand on the authorization screen. 21. When candidates use Twitter to log in to the Talent Gateway for the first time, authorization is required. ![twapp_17.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/623be907-1baa-4793-a65e-ddbf61b592a1.jpg) #### URI/URL Table > [!NOTE] > Note > > All URLs/URIs are case-sensitive. It is recommended to copy and paste the URL/URI from the following table to ensure accuracy. The last URL is for Talent Gateways in the Staging environment. **Table 19. URI/URL** | https://jobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | | --- | | https://xjobs.brassring.com/tgwehost/SocialMediaIntegration.aspx | | https://localhost/tgwebhost/SocialMediaIntegration.aspx | | https://krb-jobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | | https://sjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | | https://krb-sjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | | Any custom domain that the client might be using. | | https://sstagingjobs.brassring.com/tgwebhost/SocialMediaIntegration.aspx | ### Google Login and Google Drive API instructions Product: **BrassRing** Google Login and Google Drive API Contact your organization's Infinite representative before the Google Login and Google Drive API keys are updated as the candidate experience might be impacted by the update. When candidates log in to Talent Gateways by using the**Sign In with Google** option, a unique ID is created and mapped, and their Talent Gateway account is connected to their Google profile. For these candidates to continue logging in to the Talent Gateway by using their Google profile, this unique ID must not change. If the API keys are updated in Workbench, the candidates that were accessing the Talent Gateways with their Google profile are not able to view their previous job submissions. This is because a new unique ID is created for the new API key. If the API key is updated, Google returns a different Unique-ID for the same Google credentials. The Infinite Talent Gateway creates a new account for that profile instead of logging the candidate into the old profile, as the mapping for this new Unique-ID cannot be found. There are two options for resolution: Revert to the Old API keys, so that the old candidates who logged in before the new API keys were updated, can safely log in to their profile. This can affect the candidates who logged in after the new API keys update. Leave the new API keys as it is and ask the candidates (who submitted with old API keys) to log in to the Talent Gateway and update their profile in the profile page (candidate zone) with the same details as before. This stacks their profiles with the previous talent record in BrassRing. After it is stacked, they can see the previously submitted applications in the TG. **The process on this page shows the process on a third-party website. This website and process is subject to change without notification. Infinite is not responsible for the content on third-party websites.** #### Google Drive API instructions This process must be done twice. Once for staging and again for production. #### 1. Create the Client ID 1. Access [https://console.developers.google.com/start](https://console.developers.google.com/start), and select the **Select a project** pull-down menu. ![GD1.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/a0edf405-484c-4a32-beb0-d07fa223681e.png) 2. Select **New project.** ![GD2.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/736eb731-d060-4bf6-baba-847be5f5859d.png) 3. Insert a **project a name**, and optionally insert a **Location**, then select **Create** ![GD3.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/fd12d101-8f93-4d2f-b589-5b5e6b89a3c0.png) 4. Select **ENABLE APIS AND SERVICES.** ![GD4.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/7e92e4a7-913d-4378-b4f4-f2e9583eda3a.png) 5. Search for **Google Drive API**, and select **Google Drive API.** ![GD5.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/f9cbceea-a25b-45e5-9467-7baa222d39db.png) 6. Select **Enable**. If the API has previously been enabled the **Enable**button cannot be selected. Select **Manage** ![GD6.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/2484fa06-30fc-446b-8025-10d600839e1f.png) 7. After the API is enabled, select **Create Credentials.** ![GD7.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/e7398ed1-122d-491e-b39b-38b37ac67341.png) 8. Add credentials to your project screen: **What data will you be accessing?:** select **User data.** ![GD8.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/2196b0e9-3440-4878-96ac-9ee6d6bc33e9.png) Click **Next**. 9. Select **OAuth Consent Screen** ![GD9.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/071bb5de-87c8-4950-a996-634d986e0dcb.png) App information - This shows in the consent screen, and helps end users know who you are and contact you a) Insert name of the app asking for consent b) Insert User Support email – For users to contact you with questions about their consent. c. App Logo - This is your logo. It helps people recognize your app and is displayed on the OAuth consent screen. d. Developer Contact Information - These email addresses are for Google to notify you about any changes to your project. **Click Save and Continue** 10. Scopes(Optional) Click Add or Remove Scopes Scopes express the permissions you request users to authorize for your app and allow your project to access specific types of private user data from their Google Account. ![GD10.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/770786b6-f0a1-48df-8415-2d263047fc92.png) Select **../auth/drive.readonly** **See and download all your Google Drive files.** ![GD10a.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/bbc0f626-f223-40e7-9232-9a838170d6ee.png) Click **Update** to update selected scopes ![GD10b.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/a6fee8a4-c82c-4973-b108-5256c95a4c48.png) Click **Save and Continue** 11. **OAuth Client ID** Select Application Type – Web Application Name - The name of your OAuth 2.0 client. This name is only used to identify the client in the console and will not be shown to end users. ![GD11.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/b1dbf1dd-8412-4fde-be7b-546169261361.png) Select the URL’s from the below list and click Create. a. Authorized JavaScripts origins: Enter the URL from the list and select enter to add. · Staging URL: https://sstagingjobs.brassring.com US Production URL: https://sjobs.brassring.com US Production URL: https://xjobs.brassring.com EU Production URL: https://krb-sjobs.brassring.com b. Authorized redirect URLs: Enter the URL from the list and select enter to add. Staging URL: https://sstagingjobs.brassring.com/TGWEBHOST/mobile/cscallback.aspx US Production URL: https://sjobs.brassring.com/TGWEBHOST/mobile/cscallback.aspx. For US Production both the URLs should be added. US Production URL: https://xjobs.brassring.com/TGWEBHOST/mobile/cscallback.aspx. For US Production both the URLs should be added. EU Production URL: https://krb-sjobs.brassring.com/TGWEBHOST/mobile/cscallback.aspx 12. Download your credentials - Download this credential information in JSON format. This is always available for you on the credentials page. Click **Done** ![GD12.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/a4799631-9050-4777-947a-98e636812760.png) 13. Click **Create Credentials.** Select **API Key** ![GD12a.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/264202ba-0842-4cb3-a3a3-a00d9df16874.png) ![GD12b.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/7f970427-7ede-475c-b47a-be9a6b409d5f.png) Use this key in your application by passing it with the key=API_KEY parameter. ![GD12c.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/1d4c8518-8319-48da-b57c-ce649b1e4b87.png) 14. Select **OAuth CONSENT SCREEN**. ![GD13.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/8647693e-d292-4a99-9d17-531682a1ecf4.png) Select **Publish App** ![GD13a.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/2dca59b6-b1e0-4663-af6f-fdc283223685.png) Push to Production screen appears. ![GD13b.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/de6364b6-7636-48fa-b0ba-485d847288c6.png) Click **Confirm** and then click **Prepare for Verification**. ![GD13c.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/b6712c49-4058-4342-b2d2-6d5614030e27.png) Upon clicking Prepare for Verification ![GD13d.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/e2ad5b1d-cbd6-46e7-b757-90352301d104.png) 1. Insert the Talent Gateway page into the [Application Homepage link] field. 2. In the [Application Privacy Policy Link] field: a) If your organization is not using a vanity URL for the Talent Gateway, insert the Privacy Policy link: https://jobs.brassring.com/TGnewUI/PrivacyPolicy.html b) If your organization is using a vanity URL for the Talent Gateway, use the privacy policy that's hosted on the domain, and ensure it is available on the footer of the Talent Gateway. This helps in Google's approval process. ![GD13e.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/a8a82299-10db-4d03-bcd3-ce3afe377810.png) On the authorized domain page a) If your organization is not using a vanity URL for the Talent Gateway, insert brassring.com. b) If your organization is using a vanity URL for the Talent Gateway, insert the vanity URL. ![GD13f.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/c34fe03e-84e6-4436-b646-84bc46c2ed48.png) Click **Save and Continue**. ![GD14a.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/d96ebab3-270d-483a-b786-80f58a1f4cb2.png) If you add sensitive () or restricted () scopes, like scopes that let you access a user's emails or contacts, you will need to submit your app for verification. ![GD16.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/e5b4997a-701e-459d-b885-3a5b00e7a135.png) **What features will you use?** ![GD16a.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/02c730e0-66e0-4916-a59d-9ce4c5fb68b6.png) **How the scopes be used?** (Explain to Google why you need these scopes, how you will use them, and why more limited scopes aren’t sufficient) Insert the below message: Infinite Talent BrassRing is an applicant tracking system that deals with posting jobs and candidates applying to the same via the home page URL provided in the OAuth section of the app. The home page URL is a career site and the home page displays the search boxes to search for the career opportunities and candidates can start applying by creating a login. So, the main functionality of the home page is to display jobs based on the search criteria selected and also the status of the previously applied jobs by logging in. Now, the Google Drive functionality will be used in the process of uploading a resume for the selected job. Candidate initially logs in and then selects the upload button to import their documents like Resume, Cover letter, attachments, etc. to upload during the application process. ![GD17.png](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/0fff2ad4-4981-4823-933b-f1664d526300.png) Please provide a YouTube video demonstrating how you will use the data from these scopes in your app. Your video must include all OAuth clients that you assigned to this project. Click **Save and Continue** ### Apply With LinkedIn Abstract Product: **Workbench** #### Prerequisites - Infinite Talent has no control over the function, design, or pages that the **Apply with LinkedIn** button appears on. The format, location, and the buttons text, font, size, and colors, are all static attributes dictated by LinkedIn. **The Apply with LinkedIn** button label also cannot be edited. - The Client Setting Enable Social Media Integration → LinkedIn - Apply with LinkedIn must be enabled. Client settings can only be enabled by Infinite Representatives. - If the client setting is enabled, but the social media configuration is not completed, the Workbench administrator sees an error message on selecting **LinkedIn - Apply with LinkedIn.** The error does not prevent the user from selecting this option. However, the **Apply with LinkedIn** button is not displayed on that specific Talent Gateway until the client level configuration is completed." - The workbench administrator must have login credentials for **Apply with LinkedIn-Infinite** client admin account on LinkedIn Recruiter (appropriate for environment and Parent keys). - As per guidelines from LinkedIn, your organization is required to enable either the [Skip Sign-in](/v1/docs/configure-skip-sign-in-on-responsive-talent-gateways) (Bypass Login) or [Disable Sign-in](/v1/docs/configure-talent-gateways-and-gateway-questionnaires) functions on the Responsive Talent Gateways to use Apply with LinkedIn. - When configured, the **Apply with LinkedIn** button is available on the **Job Details** page next to the regular **Apply**button. If your organization skips the **Job Details**page your candidates do not have this action available to them. - The configuration for this LinkedIn feature does not overlap with any other LinkedIn feature offerings that are used within BrassRing. Each of the LinkedIn integration features like**Apply with LinkedIn** and**Signing in using LinkedIn,** have their own configurations. - The Apply with Linked feature is for single job applies only. #### Apply With LinkedIn Candidate Experience - When candidates select **Apply with LinkedIn**, LinkedIn confirmation windows is displayed for confirmation to proceed. When candidate provides confirmation, the candidate's LinkedIn information is pulled into their Talent Gateway profile. - List of fields pulled from LinkedIn: - First Name (required) - Last Name (required) - Email address (required) - Web address (Candidate's LinkedIn profile URL) (required) - Country (optional) - Phone Number (optional) - Up to 3 education fields (optional) - Up to 5 Work experience fields (optional) - Up to 50 skills fields (optional) - The candidate's Talent Gateway profile information is overwritten by the candidate's LinkedIn profile information if it belongs to the same fields. - Candidates cannot submit duplicate applications using the **Apply with LinkedIn** feature unless the requisition supports multiple submissions. - There is no integration with the LinkedIn app on phones or tablets. Candidates using those devices need to be logged into LinkedIn on their browser to see the **Apply with LinkedIn** button. - The **Apply with LinkedIn**button's label is displayed in the language of the candidate's LinkedIn profile. It might match the locale of the Talent Gateway in which the candidate is submitting their application. For example, if the candidate's LinkedIn profile is in French and the candidate is on a Spanish locale responsive Talent Gateway, the Apply with LinkedIn button's label is displayed in French. #### Best Practice Suggestions - Clients should not bypass **Job Details** page if they want candidates to be able to use this feature. **Apply with LinkedIn** feature is available only on Job details page. - Clients should not use read-only fields for Internal SSO TG (XML profile import) if they want candidates to be able to use this feature. - Regular Talent Gateway apply has a better profile import (with full resume data extraction) if the candidates have a resume file. Therefore, it is recommended to not use this feature unless your organization expects a significant candidate volume where candidates have a LinkedIn profile and do not have resume files available to upload, from their laptop/device, or cloud storage applications like Google Drive or Dropbox. #### Process #### Enable the Apply with LinkedIn button A LinkedIn Recruiter account is required for this configuration. 1. The**LinkedIn – Apply with LinkedIn** client setting must be enabled. Contact your Infinite Representative to enable this setting. 2. Log into your LinkedIn Recruiter account on your browser. 3. In Workbench, select Tools → Settings → Social Media Configuration. 4. Select the**LinkedIn – Apply with LinkedIn Administer configuration** icon. For this step you need to be logged into your LinkedIn Recruiter account in the same browser session so the LinkedIn API can display their page by using the API. ![image008.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/d02ed365-1c94-491b-9da8-a42aea21ac1d.jpg) 5. In the Administer Configuration window, select **Request**for **Apply with LinkedIn**. This section of this page is controlled by LinkedIn. ![image009.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/759cdeae-eabb-4cc2-9fb7-d2f4d4ddc52d.jpg) 6. A message displays stating that the integration has been successfully requested, select **Go back.** 7. The Apply with LinkedIn section displays an **Enabled**message. ![image010.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/3385db0e-56b5-403e-97c8-e56d03182f2c.jpg) 8. Select **Close**. #### Configure the Apply with LinkedIn button to display 1. Select Tools → Talent Gateways. 2. Select the **Administer Talent Gateway** icon for the Talent Gateway to have the button. 3. Select Social Media Integration → LinkedIn – Apply with LinkedIn. ![image011.jpg](https://cdn.us.document360.io/4bb62c4c-9973-48ec-ab93-23d4b1755503/Images/Documentation/83059049-26a7-4261-8d21-c5dddc38ff99.jpg) - A notification displays if the**LinkedIn – Apply with LinkedIn**button has not been enabled. 4. Select **Save**. ### Dropbox App Guide Abstract Product: **Workbench** #### Dropbox Configuration To enable candidate access to their Dropbox accounts when applying by using mobile devices, clients must create and configure their own Dropbox app. The Dropbox app needs to be submitted to Dropbox for testing and approval of production status. After production status is approved by Dropbox, there is no limit on the number of candidates accessing the Dropbox app by using BrassRing Talent Gateways per day. By creating their own app, clients can display their branding on the Dropbox authentication page. #### Create a Dropbox App 1. Access the Dropbox developers page: [https://www.dropbox.com/developers](https://www.dropbox.com/developers), select **My Apps**, and insert your **Dropbox log in** credentials. 2. Select **Create App**. 3. Select Choose an API → Dropbox API. 4. Select **Full Dropbox– Access to all files and folders in a user's Dropbox** access. 5. Insert a name for the Dropbox App. Enter an appropriate name that matches your company name to get your app approved for production. 6. Select **Create App.** 7. The App details opens, select **Enable additional users**, increase the limit to 500 users and select **Ok**. 8. Take a note of the **App key** and **App secret** as these are required to be entered into Workbench by the Infinite Representative. 9. Add the **Redirect URLs** and the **Chooser/Saver domains** to match the staging or production environment in the two fields. Add the URLs without spaces or commas with each URL on a new line. 1. **Redirect URLS:** - https://sjobs.brassring.com - https://sstagingjobs.brassring.com - https://stagingkrb-sjobs.brassring.com - https://krb-sjobs.brassring.com 2. **Chooser/Saver domains:** - sjobs.brassring.com - sstagingjobs.brassring.com - stagingkrb-sjobs.brassring.com - krb-sjobs.brassring.com 10. Select the**Branding tab** 1. Upload the logo for the App in the**App Icons** field and select **Save Changes.** 11. You have now configured the app for staging. The Dropbox App client settings, must now be enabled and configured by an Infinite Representative. #### Client and Workbench settings 1. Client Settings can only be configured by your Infinite representative. Contact your Infinite representative with a request to enable the Dropbox App client settings in the Staging Environment. Include the App Key and secret details so the Infinite Representative can enter them. 2. Synchronize the Talent Gateways after these changes and you can access the Dropbox through the API. For more information on syncing changes with Talent Gateways, see [Synchronize Changes with Talent Gateways](https://www.ibm.com/support/knowledgecenter/SSEUFV/2_Configuration/7_ConfigTGsandGQs/6_SyncChanges.html). 3. You should now test the app is working as expected. #### Applying for Production Status - Dropbox’s requirement for reviewing the application for production status is that the app should be linked with at least 50 users. You can apply for production status before this requirement is met, but the review happens only after a minimum of 50 users are linked to the app. - While applying for production status, you must give a detailed description of how your company is to use the **Dropbox App** and a **Job Apply URL** for the Talent Gateway configured with**Dropbox App** in staging for them to test the app. Dropbox does not approve the app for production unless these details are provided accurately. 1. To apply with Dropbox for production status, open the Dropbox for developers page: [https://www.dropbox.com/developers](https://www.dropbox.com/developers). 2. Access the **App details**page and select **Applying for Production Status**. 3. Enter the details as described: 1. **Confirmation**: Select**My app will need to link with more than 50 Dropbox users.** 2. **Description**: Insert **This app is an applicant tracking system where candidates apply for jobs.** 3. **Dropbox Integration:**Insert: **Job applications sometimes require candidates to submit various documents. During the process of job application, candidates might access their Dropbox account by using this app and upload the documents that they might have stored in their respective Dropbox accounts.** 4. **Website**: Insert **Yes**. 5. **Platform(s)**: Select **Web**from the list of options and insert the URL of the BrassRing Talent Gateway in which Dropbox can be accessed. 6. **Testing instructions:** Insert the detailed steps here for your Talent Gateway workflow, so that the testing team at Dropbox can follow them for testing your app. 1. Provide the Staging Talent Gateway URL and one or two test candidate credentials to log in to the Talent Gateway. 2. Describe how to search for a job, apply, how to create a profile, select the resume, upload a file by logging in to Dropbox. 3. Provide the entire flow that lets the Dropbox testing team know how a candidate is using the Dropbox by using the Talent Gateway. 7. **Test account credentials:** Provide the test account credentials 8. **Testing conditions:** Select **I have provided either test account login info or a link to a test build or a link to screenshots or a screencast detailing my app’s integration with Dropbox.** 9. **Request early review:** This is an optional field. If needed enter a reason as to why your app needs to be reviewed before 50 users are included. 10. Select**Submit app**. 4. After receiving confirmation from Dropbox that the app has been upgraded to production status, contact your Infinite Representative to insert the App Key and App Secret values in the Workbench Client Settings in the Production environment. If any of the values that are entered do not match with the values provided by Dropbox API, then an error message is displayed as opposed to Dropbox authentication page. Your organization should use only SSL-encrypted Talent Gateways for responsive apply in order to use the Dropbox feature.