User Roles on the Signiant Platform
The Signiant Platform allows users to hold different permission levels based on roles assigned to a user. When a user logs in via console.signiant.com, the user profile is called by the platform which contains the roles associated with the user, allowing access to more than one product or service at a time.
When using with the API, the client_id
, client_secret
, and generated JWT bearer token used to access the API are scoped to a single role for a single product.
To add, remove, and update users, you must use the v1/users
endpoint with the JWT bearer token generated from the client_id
and client_secret
that correspond to the necessary role for the related product.
Examples
Creating Users
To create a new user, or assign a role to an existing user, send a POST
request to the /v1/users/{email_address}/roles
endpoint with the role as the request body.
Note: Creating a new user sends an automated email to the user, prompting them to set a password for their Signiant Console account.
Example Request
{
"role": "MEDIA_ENGINE_USER"
}
Example Response
{
"roleId": "31cd79a8-bbbb-bbbb-bbbb-e3465b4e8ee4",
"role": "MEDIA_ENGINE_USER",
"createdOn": "2024-04-20T18:43:53.747Z"
}
Listing Users
To list existing users and their associated roles, send a GET
request to the /v1/users
endpoint.
Example Response
{
"items": [
{
"emailAddress": "user@example.com",
"roles": {
"items": [
{
"roleId": "c8e187a6-aaaa-aaaa-aaaa-6e6625176e4a",
"role": "MEDIA_ENGINE_IT_ADMIN",
"createdOn": "2024-04-20T17:06:26.284Z"
},
{
"roleId": "6a275d61-bbbb-bbbb-bbbb-35e466289624",
"role": "MEDIA_ENGINE_USER",
"createdOn": "2024-04-20T18:43:53.747Z"
}
]
}
}
]
}
Removing Users
To remove a user, you must remove their role using their roleId
. Send a DELETE
request to the /v1/users/{email_address}/roles/{roleId}
endpoint.
Example Response
{
"roleId": "31cd79a8-bbbb-bbbb-bbbb-e3465b4e8ee4",
"role": "MEDIA_ENGINE_USER",
"createdOn": "2024-04-20T18:43:53.747Z"
}
Note: At least one administrator must be assigned to an account.
Service and Role Reference
Product | Account Type | Service | Role |
---|---|---|---|
Flight Deck | Administrator | MANAGER_AND_AGENTS_SAAS |
MANAGER_AND_AGENTS_SAAS_ADMIN |
Jet | Administrator | S2S |
S2S_ADMIN |
Media Engine | Administrator | MEDIA_ENGINE |
MEDIA_ENGINE_IT_ADMIN |
Media Engine | End User | MEDIA_ENGINE |
MEDIA_ENGINE_USER |
Note: The Signiant Platform API is currently not available for Media Shuttle. User roles must be assigned using the Media Shuttle IT Administration console or Operations Administration console. To add portal members via the API, see the Media Shuttle Management API documentation. To modify your Media Shuttle IT Administrators, contact Signiant Customer Care.