Skip to main content

​
About Oblique

The Oblique integration connects Serval to Oblique’s public API. Workflows and the help desk agent can look up a user’s teams and direct access, find teams, file team membership requests that Oblique’s owners approve, and add or remove team members. Workflows you build can call any operation in the Oblique API. Authentication: An Oblique API key. Serval stores the key securely and sends it as a bearer token only to the Oblique host you select: us.oblique.security, eu.oblique.security, or another host in the oblique.security domain that Oblique gave you. Data sync: On demand. Serval calls Oblique when a workflow runs and does not perform a background sync.

​
Create an API key

You must be an Oblique admin to create a key.
1

Open API keys

In Oblique, open the API keys page in the admin settings.
2

Add a key

Select Add API key and enter a name, such as Serval.
3

Choose the permission

Choose Read-write so Serval can add and remove team members and file requests. Choose Read-only if Serval should only look up access; workflows that change Oblique then fail.
4

Copy the key

Select Create key and copy the key. Oblique shows it only once.
A key’s name and permission can’t be changed later. To change them, create a new key and delete the old one. See Oblique’s API key guide for details.

​
Connect in Serval

1

Name the connection

Enter a recognizable name, such as Production. Use a different name for each Oblique organization you connect.
2

Select the region

Choose United States or Europe to match the address you sign in to Oblique at. If Oblique gave you a different address, such as testing.oblique.security, choose Other Oblique host and enter it.
3

Enter the API key

Paste the key and connect.
A connection stays with the region or host it was created for. To use a different one, create a new connection.

​
Verify the connection

Serval checks that the key can list Oblique users and teams. A failed check usually means the key was deleted or mistyped, or the selected region or host doesn’t match your Oblique organization.

​
Workflows

Requests filed through Serval list the API key’s service account as the requester. Membership changes made with Add User to Oblique Team and Remove User from Oblique Team skip Oblique’s request and approval flow, so keep their approval step in Serval.
Need help? Contact support@serval.com for assistance with your Oblique integration.