SIGN UP

Service accounts introduction

Service accounts introduction

Our Control panel now has a new feature, Service accounts. This functionality allows you to create service accounts for your main developer account. From now on, API Keys are considered deprecated, use the Service accounts instead.

Roles

A service account is a way to grant access to the Voximplant HTTP API on behalf of your developer account. You can manage the permissions of each service account by assigning one or more roles to it. The following roles are available at the moment:

  • Owner
  • Admin
  • Support
  • Supervisor
  • Developer
  • CallList Manager
  • Accountant
  • Verification
  • Scenarios
  • User Manager
    • User Read
    • User Update
  • ACD Manager
    • ACD Stats
    • ACD Management
  • CallHistory

If a service account has no assigned roles, it has access to the basic HTTP API methods only:

How to use it

Go to the Service accounts section and click Add in the upper right corner. In the dialogue opened, click Add role and specify as many roles as you need. For example, if you want to enable this new account to just start cloud scenarios, add the Scenarios role. Put a short description (if needed), click Generate key, and specify where to save a private key.

ATTENTION
Since we don't store the keys, save it securely on your side.
 Next, form a JWT token using RS256. The required fields are:
  • kid – key_id to be specified in the header section
  • iat – start date
  • iss – account_id
  • exp – end date, up to iat+3600 seconds

From now on, you should substitute this token in every HTTP request to the Voximplant HTTP API, e.g.:

curl -H "Authorization: Bearer ${TOKEN}" https://api.voximplant.com/platform_api/StartScenarios/?rule_id=1
Tags:voximplantcontrol panelservice accounts
B6A24216-9891-45D1-9D1D-E7359CEB8282 Created with sketchtool.

Comments(1)

seva
2019-07-17 16:38:12
Reply
1) What is "Bearer" in your example ? -H "Authorization: Bearer ${TOKEN}" 2) iat – start date. What format (I tried seconds)? 3) exp – end date, up to iat+3600 seconds. necessarily +3600 ? 4) WHY DO NOT USE LINK FOR THIS PAGE FROM HTTPS://VOXIMPLANT.COM/DOCS/REFERENCES/HTTPAPI/AUTH_PARAMETERS? I got error {"error":{"msg":"Invalid token format.","code":447},"errors":[{"msg":"Invalid token format.","code":447}]} And I don not know how to authorized

Add your comment

Please complete this field.

Recommended

Sign up for a free Voximplant developer account or talk to our experts
SIGN UP