Integration Dashboard Access and Navigation

Abstract

Product: Integration Dashboard

Access

1. To access the Integrations Dashboard, in Workbench, select Tools → Integrations → Integrations Dashboard. Every dashboard session times out by default after 20 minutes of inactivity.

   All times that are displayed on the Integration Dashboard are based on the Data Center where the client is hosted. The US data center is in EST. The EU data center is in GMT.

    

Navigation

The integration dashboard is made up of health panes and Integration Portfolios. Users can access detailed information about each report type. The health report includes information on when an integration ran and identifies failures. The portfolio section breaks out the various types of integrations and is used to access overall and detailed integrations within the category. The integration dashboard is available for BrassRing interfaces only and does not reflect Talent Suite, Talent Insights, or Onboard integrations. The integration dashboard works for both Production and Staging environments.

The Dashboard is a responsive interface and adjusts to the size of the screen of the device used by the user. Wherever there is a grid that is used to provide data, pagination is provided to ensure smooth user experience and control over the number rows that is displayed. A keyword search can be performed on most screens.

• Select Back to return to the previous page visited.

• Select Search to search the integrations dashboard.

• Select Home to return to the integrations dashboard home page.

   

• Select Copy to copy the information on the displayed grid.

• Select CSV, MS Excel, or PDF to export the displayed grid to the selected file type.

• Select Print to print the information on the displayed grid.

Donut charts display after the Profile Tiles. Based on the integration logs, the health of the integrations displays in a set of donut charts. The donut chart indicates the success or failures for the standard integrations and there are three donut charts displayed depicting:

1. The health of integrations that were run today. This indicates the overall count of success or failures for today for standard integrations.

2. The health of integrations that were run in the last seven days. This indicates the overall count of success or failures for the last 7 days count for standard integrations.

3. The integrations run the maximum number of days are displayed. This indicates the success or failure count as per availability in the database.

Integration Dashboard Portfolios

Abstract

Product: Integration Dashboard

Portfolios

The portfolios screen displays the various integrations types and other services that clients configured in their Talent Acquisition setup. The following portfolios are displayed:

• Standard Integrations

• Premium XML Integrations

• Data Warehouse

• Custom Triggers

• Custom Reports

• Common Services

• SSO (Single Sign-On)

• Rules Automation Manager

• Workday Pre-Built

• Onboard Integrations

Double click a portfolio to open it. A detailed report of that portfolio opens. Select another portfolio by using the pull-down menu to open it. Each portfolio has two tabs. The Active tab displays all the active, running, and scheduled integrations information. The inactive tab displays all those integrations that are currently inactive.

Client Settings

• Clients Setting describe the account settings, including the settings that are enabled, such as IBM Watson Recruitment, Talent Suite, and any Talent Gateways.

  

• Select the Talent Gateways link to display the Talent Gateways that are available.

  

Useful Tips

• Select All Integrations to view a summary snapshot of all integrations.

   

• Select the i information icon to view corresponding information.

• Select the count in the Integrations graph to display logs of successful or failed integrations within that specific hour. 0 is the current hour on the x-axis and 24 is current hour minus 24. This graph shows count of success and failure of all the integration logs.

• Search for an integration record with the Message ID, a date range, success or failure status.

   

• Select the message id hyperlink to view the ability to view request and response details and to cross-check for accuracy.

Integrations Portfolio

Standard Integrations

This portfolio displays the list of all integrations that were configured by using the Mapping Tool by BrassRing Workbench users. The pie chart displays a distribution of all the types of standard integrations presently active for this client. A grid with a list of all the integrations is displayed. This grid provides information about the type of integration and the frequency at which each integration runs. Select the name of the integration to open a graph with the success-failure information displays and a grid that shows the status of various instances of the integrations for the last seven days.

Depending on the enabled standard integrations client settings, data for Watson Recruitment, Talent Suite, and Talent Gateways might be available.

• Select the Wrench icon to display Candidate or Req export settings. This displays the transmission URL with Layer 7 URL and the actual URL. It also displays whether the 2-way SSL is enabled.

• Select the Fork icon to display the field mapping for the candidate or req export

Premium XML Integrations

This portfolio displays a grid with a list of all the premium XML-based integrations that are created specifically for the client. It also displays the status, frequency at which these integrations run, and the last run date of each of the integrations. Select the name of the integration to open a graph of the success-failure status based on the number of attempts displays. A grid with the status and information of the integrations that were run in the last seven days are displayed here.

Data Warehouse

For clients that have engaged Infinite Technical Solutions Expert (SE) team in posting the client’s bulk BrassRing data to FTPs, is listed under the Data Warehouse integration portfolio. The names of the Data Warehouse integrations are hyperlinks. Select the name of the integration to open a graph of the success-failure status based on the number of attempts. A grid with the status and information of the integrations that were run in the last seven days are displayed in the data warehouse pane.

Custom Triggers

Custom Triggers are customized action-based triggers that are scheduled to perform a designated set of tasks. A list of all such integrations is displayed under Custom Triggers Portfolio. This grid displays a list of all integration names, integrations types, the frequency at which each of the integrations run, their last run date and time, and the status of whether the integration is success or a failure. Custom triggers are built by the Infinite Technical Solutions Expert team, showing RAM exports that are configured by them where they export data to external systems. Triggers include:

• Custom triggers built by the Infinite Technical Solutions Expert to fire off integrations.

• Self-Service RAMs built by the Infinite Technical Solutions Expert or Client.

• Automation Manager triggers, by using the standard triggers available under the Automation Manager configuration.

Custom Reports

Custom Reports are all those reports that were created based on client request and are not produced by the Data Insight Tool. These reports are provided by the Infinite Technical Solutions Expert team based on the requirements that are provided by the client. Selecting the count in the reports pod, displays the list of reports available with a time log.

Common Services

Common Services Integrations are client integrations with BrassRing vendors by using the common services integrations that do not require Infinite Technical Solutions Engineering effort. The grid provides all the information about the common services integrations this client has purchased or implemented with the various BrassRing vendors.

SSO

The Single-Sign-On (SSO) grid lists SAML 2.0 Single Sign On instances in place for users logging into BrassRing and BrassRing Talent Gateways. Select the count in the SSO pod to view all SSO activity. The SSO tile does include SSO into the Talent Acquisition Suite or any BrassRing or BrassRing Talent Gateways that are housed in the suite.

Rules Automation Manager

This grid lists all the RAM Export integrations that are configured by the client and includes:

• Identity names of all the integrations.

• The type of integrations.

• The frequency at which each integration is run.

• The status.

• The last run date and time.

Workday Pre-Built

View Workday Pre-Built integrations.

Onboard Integrations

View integrations between Infinite Talent Onboard on Could and external systems in the Integrations Dashboard. This gives you the visibility into your Onboard integrations that you previously didn’t have, and can be used to help troubleshoot issues or view activity.

Security Certificate Update Tool

Abstract

The purpose of this document is to present step-by-step details on how to refresh a client or vendor specific certificate that is used for existing Security Assertion Markup Language and Single Sign-On (SAML-SSO) integration for Infinite Talent BrassRing.

Note

This tool is not currently available for clients. Please contact Infinite if you have any questions about this tool.

Tool and Guide - Introduction

Abstract

Use this self-service tool to update or refresh the X.529 certificates that are used for Security Assertion Markup Language (SAML) based Single Sign-On (SSO) enabled stand-alone BrassRing or Talent Gateways or both.

Single Sign-On (SSO) Certificate

If your instance of BrassRing or Talent Gateway or both is inside SAML SSO enabled Talent Suite, the certificate needs to be refreshed by accessing the Talent Suite - Admin application. Steps for the refresh are found on the Configuring Single Sign-On page of Infinite Documentation.

To update a certificate or key for RSA (private and public key-based crypt-systems to encrypt data) based SSO, open a Support Ticket with Infinite Global Support Center.

A SAML SSO certificate update or refresh for BrassRing or Talent Gateway or both is out of scope if your organization uses Talent Suite.

Requirements for the tool

A valid Base 64 encoded single X.509 certificate file with either .CER or .CRT extension.

Audience for the tool guide

• Client Internal IT Teams, Systems Integrators, and Support Teams.

• BrassRing Engineering Services team, Support team, and Technical Services group.

View and Install a Certificate

Abstract

Follow appropriate steps to view the current certificate, update the certificate in real time, or schedule it and download valid historical certificate.

View an Existing Certificate

1. To View an existing certificate, select View Certificate Details

• Each card represents one certificate. You might have multiple cards if you use multiple certificates.

  • For example, if Certificate A is used for the Kenexa BrassRing application and Certificate B is used for the Referral Gateway, two cards are present.

  • If you need to refresh multiple certificate or Cards, repeat installation steps for each.

• If the Card includes multiple applications (Green bars), the same certificate is used for each of those applications.

• The Card displays information that pertains to the current certificate. If the expiry date is within one month, Expires show in Red.

• If you have language-specific SSO enabled Talent Gateways part of the Global Talent Gateways, you can view them by selecting the ellipsis icon.

• The application “Infinite Talent BrassRing” might mean:

  • You have SSO enabled BrassRing recruiter portal, or.

  • You have SSO enabled eLink, or.

  • You migrated to Talent Suite, but the lingering record is still there. If so, it will go away when the next certificate expires. To refresh certificates of SSO enabled Talent Suite, use the Admin application.

    

    

Upload and Install a Certificate

1. To upload and install a certificate, select View Certificate Details.

2. Drop a valid X.529 Base-64 Encoded .CER/.CRT file into the "drag and drop" section, or select browse, select the certificate, and select Open. The certificate is validated after it is uploaded.

   • If certificate is not valid, an alert is displayed.

   • The details of valid certificate are displayed in gray.

     

3. Select Install Now to refresh the certificate in real time.

4. A message is displayed requesting confirmation to proceed for installation. Select Yes.

   • The installation completes in 5 to 15 minutes depending on the environment.

     

5. An Alert Notification is displayed under the Notification tab to indicate that the refresh process has started.

   

6. The card reflects the processing status.

   

7. After the process is complete, another Alert Notification is displayed under the Notification tab to indicate the outcome.

   

8. The card shows the details of newly installed certificate if the process was successful.

   

9. Selecting View Certificate Details displays the status of the installation. The status displayed is helpful to track the progress of the cert installation. Visit this page by selecting View Certificate Details to view the latest status.

Schedule a Certificate Installation

1. To schedule a certificate installation, select View Certificate Details.

2. Drop a valid X.529 Base-64 Encoded .CER/.CRT file into the Drag and drop section, or select browse, select the certificate, and select Open. The certificate is validated after it is uploaded.

   • If certificate is not valid, an alert is displayed.

   • The details of valid certificate is displayed in gray.

3. Select Schedule.

4. Insert a date and time for the installation to occur.

5. Optionally insert an email address. Multiple emails must be separated by a comma. The email address receives an email notification with the outcome of the installation.

   

6. Select Schedule to turn on the schedule.

7. Select Save.

8. An Alert Notification is displayed under the Notification tab to indicate that the refresh has been scheduled. And, the Card reflects schedule details.

   

Update or Disable a Scheduled Installation

1. To update a schedule, select View Certificate Details.

   1. Select Schedule.

   2. Select new date, time, and email.

   3. Keep the Schedule slider turned on.

1. To disable a schedule, select View Certificate Details.

   1. Select Schedule.

   2. Select the Schedule slider to turn off the schedule.

   3. Select Save.

Download a Historical Certificate

The system backs-up existing certificates before it updates with a new one. If backed-up certificate is valid, it can be downloaded. Currently installed certificate is not available to download.

1. Select the Historical Certificates icon. A list of available certificates is displayed.

    

2. Select the download arrow for the certificate to download.

   

Frequently asked questions

Abstract

Questions that frequently come up during certificate installation.

• Can I update certificate for my SSO enabled Talent Suite BrassRing or Talent Gateway or both in Talent Suite?

  • To refresh certificates for Talent Suite BrassRing or Talent Gateways that are inside Talent Suite, use the Talent Suite: Admin app.

• Can I update certificate if SSO is not SAML-based?

  • For RSA-based SSO, open a support ticket with the Infinite Global Support Center.

• Why don't I see certificate details?

  • In the following scenarios, certificate details might not be available, if:

    • BrassRing or Talent Gateway is not SSO enabled.

    • Your organization users Talent Suite BrassRing or an Internal Gateway is inside the Talent Suite.

    • BrassRing or Talent Gateway SSO is based on RSA instead of SAML.

• What kind of Certificate file must I use?

  • A valid Base 64 encoded single X.509 certificate file with either .CER or .CRT extension.

• What if I get failure message or email after completion of certificate update?

  • Open a support ticket with the Infinite Global Support team.

• My BrassRing or Talent Gateways or both use a common certificate. Can I separate them to use multiple certificates?

  • The system was configured with a combination of certificates. If they need to be separated, or combined to use multiple, or single certificates, open a support ticket with the Infinite Global Support team.

• How much time does it take to install certificate?

  • Based on environment, it can take approximately 5 - 15 minutes.

• What if SSO stops working after I update the certificate?

  • Clear the cookies of the browser and make sure that your IT team updated the system on your end with the same certificate.

  • Make sure the user that is testing the integration has access to the system. If the prior steps were followed and the error persists, open a case with the Infinite Global Support Center and provide SAML Response. Following are the steps to view a SAML response based on browser.

  • To View a SAML repose in Chrome (These steps were tested using version 54.0.2840.87m. If you use another version, you might need to adapt the steps.)

    1. Press F12 to start the developer console.

    2. Select the Network tab, and then select Preserve log.

    3. Reproduce the issue.

    4. Look for a SAML Post in the developer console window. Select that row, and then view the Headers tab at the end.

    5. Look for the SAMLResponse attribute that contains the encoded request.

  • To View a SAML repose in Firefox (This procedure was tested on version 37.0.2 of Mozilla Firefox. If you use another version, you might need to adapt the steps.)

    1. Press F12 to start the developer console.

    2. In the developer tools window, click options (the small gear icon). Select Enable persistent logs in Common Preferences.

    3. Select the Network tab.

    4. Reproduce the issue.

    5. Look for a POST SAML in the table. Select that row.

    6. In the Form Data window on the right, select the Params tab and find the SAMLResponse element.

  • To View a SAML repose in Internet Explorer

    1. The best way to analyze network traffic in Internet Explorer is by using a third-party tool.

    2. Follow the steps at this page to download and install Fiddler and capture the data.

  • What to do with the Base64-encoded SAML response?

    • When you find the Base64-encoded SAML response element in your browser, copy the response and use your favorite Base-64 decoding tool to extract the XML tagged response.

Note

Security Tip: The SAML response data that you are viewing might contain sensitive security data. Therefore, we recommend that you do not use an online Base64 decoder. Instead, use a tool that is installed on your local computer that does not send your SAML data over the network.