getting started with grey tower restful api
TRANSCRIPT
GreyTower Identity Integration
-Restful API tutorial
Getting started with Grey Tower Identity Restful APis
Targeted Audience (Assumptions)
This presentation makes the assumption that the reader is somewhat technical (Developer or Engineer)and is familiar with the following concepts
Authentication
Authorization
Restful APIS
Basic PKI concepts
Grey Tower supports Several Authentication methods
Basic Multifactor Authentication
(Username+Password+APIKey)
Authorization key
Authorization Certificate
Restful API Authentication
Graded Authentication Tokens
Basic Multifactor
Authentication
Authentication Token
(Valid for 24 Hours)
Authentication Certificate
(Valid for 30 Days)
Requires basic multifactor Authentication
Requires Authentication Token
User Name+Password+APIKey
Basic Multifactor authentication (username and password+ API Key) Required to get the secure authorization token
Restful API Example
URL - http://scim.cloudhub.io/api/Authorization
Post body content "name": "[email protected]", "password": "greycondo",
"apiKey": "f9QzEk6wmY1rvPWDMkrzIRSTTm8SwTtj"
Returns an Authorization key FB43C16B219678454CF5B86D63C7885E17A37660BCBA09E066472AD17
B35E0B96AE6C98A9C0D9DA651C15178A1C4E58D5C85650998C27F4C
Initial Authentication (Multi Factor)
Requires a secure authorization token
URL - http://scim.cloudhub.io/api/Authorization
Post body content "name": "[email protected]", "password":
"greycondo", "apiKey": "f9QzEk6wmY1rvPWDMkrzIRSTTm8SwTtj"
Returns an Authorization key FB43C16B219678454CF5B86D63C7885E17A37660BCBA0
9E066472AD17B35E0B96AE6C98A9C0D9DA651C15178A1C4E58D5C85650998C27F4C
Get Certificate Authorization Cert
Requires an Authorization token
URL -http://scim.cloudhub.io/api/V1/SCIM/Users/Certificate
Header Content Authorization:
FB43C16B219678454CF5B86D63C7885E17A37660BCBA09E066472AD17B35E0B96AE6C98A9C0D9DA651C15178A1C4E58D5C85650998C27F4C
Returns an Authorization certificate
Authorization Certificate
The Authorization Token is a Salted AES 256 bit encrypted String
Only valid for 24 hours
Required to authorize all future API calls
Example Authorization key FB43C16B219678454CF5B86D63C7885E17A37660BCB
A09E066472AD17B35E0B96AE6C98A9C0D9DA651C15178A1C4E58D5C85650998C27F4C
Authorization Token
256 bit AES Certificate.
The Certificate is returned as a string
Valid for 30 Days
Required to authorize all future API calls
Example Authorization Certificate FB43C16B219678454CF5B86D63C7885E17A37660BCBA09E0664
72AD17B35E0B96AE6C98A9C0D9DA651C15178A1C4E58D5C85650998C27F4C8454CF5B86D63C7885E17A37660BCBA09E066472AD17B35E0B96AE6C98A9C0D9DA651C15178A1C4E58D5C85650998C27F48454CF5B86D63C7885E17A37660BCBA09E066472AD17B35E0B96AE6C98A9C0D9DA651C15178A1C4E58D5C85650998C27F4
Authorization Certificate
What you will need
Greytower Identity Domain Register for you free domain at https://scim.cloudhub.io
Chrome Browser
Organization API Key The api
key is sent to you on initial registration Username [email protected] Password password
Examples
Example – Get Authorization Key
URLhttp://scim.cloudhub.io/api/Authorization
Header• Content-Type: application/json
Body • "name": "[email protected]", "password":
"greycondo", "apiKey": "gwNfdLhiSpoR2xtLAtdK3n3Kq6XBH3XZ"