Agenda requires the OnBase Application Server to communicate with OnBase. You must also configure the Application Server to use IdP authentication. See Configuring the Application Server to Use IdP Authentication.
To configure Agenda to use the Hyland IdP server for authentication:
-
Configure a client connection on the Hyland IdP server for Agenda to use.
Tip:
If you have already set up a client connection for the OnBase Unity Client you should be able to use the same connection for Agenda. Complete details on configuring a client connection on the Hyland IdP server are documented in the separate Identity and Access Management Services documentation. Version compatibility with OnBase Foundation releases is documented in the Version section of that documentation.
The client connection must have the following settings, as well as any standard required settings. All other settings can be left with the default values.
Setting
Value
Protocol Type
oidc
Redirect URLs
The URL of the Service.asmx page of the OnBase Application Server. This value must be the same as the ServicePath configured for the Unity Client, which must be all lowercase.
Allowed Grant Types
Authorization Code
Allowed Scopes
openid
Post Logout Redirect URLs
The same URL as the Redirect URLs value. This value must be all lowercase.
Pkce
Select Require PKCE
Secret
Do not select Client Secret must be present
-
After saving the client connection, copy the Client ID value to the clipboard by clicking the icon at the right of the Client ID field.
Tip:
Recycle the application pool of the Hyland IdP server in IIS for any configuration changes on the Hyland IdP server to take effect.
- Open the obagenda.exe.config file of the Agenda application for editing in a plain-text editor.
- Locate the ServiceLocations element.
- Locate the <add ServicePath element for the OnBase Application Server and data source Agenda uses.
- Paste the client ID value you copied from the Hyland IdP server into the value of the IdpClientId attribute. This is the unique ID of the client on the Hyland IdP server. This value is case sensitive and must match exactly the value on the Hyland IdP server.
-
Set the value of the IdpUrl attribute to the endpoint of the Hyland IdP server. This value is case sensitive.
For example, if your domain is my.domain and the Hyland IdP application name is identityprovider, then the value is: https://my.domain/identityprovider
-
Set the value of the AuthenticationType attribute to Idp.
Note:
This value is case sensitive. Note the uppercase I in Idp.
- Save and close the obagenda.exe.config file.