{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21074,"path":"integrate-applications/integration-hub/configure-connection-ukg-spoke.md","title":"Configure a connection for the UKG spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Configure a connection for the UKG spoke\n\nAdd and configure a connection using the UKG spoke connection template in Flow Designer to authenticate ServiceNow requests to your UKG instance.\n\n## Before you begin\n\nRequest an Integration Hub subscription.\n\nActivate the UKG Spoke.\n\nRole required: admin\n\n**Note:** If you're updating from a previous version \\(before version 3.3.0\\) of the spoke, first you must remove the current connection record, credentials record, and Kronos user credentials. Then, you can set up the connection.\n\nUKG has updated its authentication mechanism from legacy Auth to AuthN. If you're setting up the spoke for the first time, use AuthN to configure the spoke. If you have previously configured the spoke using the legacy Auth, you can continue using your existing configuration or migrate to AuthN.\n\n**Note:** Verify that the application registry, connections, and credentials are within the application scope.\n\n## Procedure\n\n1. Navigate to **All** > **Process Automation** > **Flow Designer**.\n\n2. Select the **Connections** tab.\n\n3. Locate the **UKG connection** alias and select **View Details**.\n\n **Note:** Don't select **Add Connection**.\n\n \\[Omitted image \"ukg-spoke-conn-template.png\"\\] Alt text: Connection template for UKG spoke.\n\n4. Select **Edit**.\n\n If you're configuring the spoke for the first time, select **Configure**.\\[Omitted image \"ukg-spoke-config-conn.png\"\\] Alt text: Configure a connection for the UKG spoke\n\n5. On the form, fill in the fields.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nConnection Name\n\n\n\nName to uniquely identify the connection record. For example, enter Kronos Conn.\n\n
\n\nConnection URL\n\n\n\nURL of the Kronos instance.\n\n
\n\nRealm\n\n\n\nRealm of the Kronos instance.\n\n
\n\nUsername\n\n\n\nUsername to log in to the user's account in Kronos.\n\n
\n\nPassword\n\n\n\nPassword of the Kronos user account.\n\n
\n\nOAuth Entity Name\n\n\n\nUnique name to identify the OAuth entity profile of the UKG spoke. For example, select `UKG OAuth entity`\n\n.\n\n
\n\nOAuth Client ID\n\n\n\nClient ID created during the application configuration in Kronos.\n\n
\n\nOAuth Client Secret\n\n\n\nClient Secret created during the application configuration in Kronos.\n\n
\n\nToken URL\n\n\n\nOAuth server token endpoint. For example, `https://.com/api/authentication/access_token`.**Note:** If you're using the AuthN mechanism,enter `https://welcome-eval.ukg.net/oauth/token`.\n\n
6. Select **Configure and Get OAuth Token**.\n\n A modal page displays to enter your Kronos credentials.\n\n7. Enter your Kronos username and password and select **Get OAuth Token**.\n\n8. If you're using the legacy Auth mechanism, you must provide user credentials.\n\n For more information, see [Provide Kronos user credentials](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/create-user-cred-kronos.md).\n\n9. If you're using the legacy Auth mechanism, you must set the refresh token lifespan.\n\n 1. Navigate to **All** > **System OAuth** > **Application Registry**.\n\n 2. Open the record for the Kronos spoke.\n\n 3. On the form, navigate to the **Refresh Token Lifespan** field.\n\n 4. Enter `28800`.\n\n\n## Result\n\nOnce your OAuth token has been successfully fetched, you can begin using your UKG spoke connection.\n\n"}}