Establish Connection between Recording Service and Timeline
For interaction between Recording Service and Timeline components, it is recommended to register Recording Service as a client on the Timeline website.
Important. Timeline does not have backward compatibility with older Recording Service versions. That means, if you are planning to use Timeline 6.1, you should have Recording Service 6.1 also.
Basic steps
- Register Recording Service as a client on the Timeline website and obtain credentials (Client ID and Client Secret).
For more information, see the Registering a New Client on Timeline website section below. - In the Recording Service website specify the authentication details to Timeline using the credentials you obtained in step 1.
For more information, see the Configuring authentication setting in Recording Service section below.
Registering a New OAuth Client on the Timeline website
Role required: Timeline account Admin
- Open the Timeline website and login using credentials specified during the Timeline Installation.
- Click your user avatar at the bottom of the left bar and select Account. Expand the drop-down list of account sections by clicking the name of the current one in the upper-left corner (Details by default). Open the OAuth & OpenID Connect tab and click Register client.
- In the Register OAuth client form, fill in the following fields:
- Name
Enter a unique name that identifies the application that you require OAuth access for. For example, RecordingService.
Note. The specified name is then presented to a user in the consent screen on the Recording Service website, make it clear to your users. - App URL
Enter the URL that hosts Recording Service. For example, https://recorder.myCompany.com
Note. To get the correct App URL and Redirect URI for the Recording Service, open the Recording Service website in your browser and go to the Settings tab. There you will find the "Timeline Authentication Guide". Find the value you need, copy, and paste it into the appropriate field on the Register OAuth Client form on the Timeline website. - Redirect URI
Enter the callback URL that the authorization server redirects to. Enter the full URL of the clients requesting access to the resource, appended by /api/auth/callback. For example, https://recorder.myCompany.com/api/auth/callback - Client logo
This is optional. You may upload an image to use as the application logo. The logo appears on the approval page when you receive a request to grant a client application access to a restricted resource on the instance. - Client type
Select Confidential as Recording Service is able to securely authenticate with the authorization server, for example being able to keep their registered client secret safe. - Grant type and OpenID Connect
You can keep default values. - Scopes
Select Read projects and Write projects scope values to request access to submit data from Recording Service to Timeline. An application can request one or more scopes, this information is then presented to a user in the consent screen, and the access token issued to the application will be limited to the scopes granted. - Click Register.
You will be able to see auto-generated unique Client ID and Client Secret for the application. Copy these values to use in Recording Service.
Configuring authentication setting in Recording Service
Permission required: your account must be added to the Active Directory group specified during the Recording Service installation, which contains the email addresses of the Recording Service administrators.
- Open Recording Service website.
- Go to the Settings > Timeline Authentication and fill the fields in:
- Timeline URL
Enter the URI of the Timeline website. - Client ID and Client Secret
Enter the Client ID and Client Secret you obtain after registering the client in step 4 'Registering a New Client on the Timeline website' section. - Click Save.
Please wait for notification. If the connection is successful, it displays Save. Otherwise, an error appears: 'The server is unreachable, please notify the administrators and try again later'.
If connection fails: - Check the connection settings you specified above.
- Make sure the Timeline website is available.
- Check the firewall settings. For more information, see the Network Connection Settings.
- Make sure the ports specified during the Recording Service installation are not being used by other applications. For more information, see the Check TCP/IP Port Availability.
9/5/2024 4:23:54 PM