Login
General
URL
https://{host}/attunityenterprisemanager/api/v1/login
Description
Authenticates an API caller with Enterprise Manager using Active Directory, and acquires a session token to be used with API method calls. The server requests client authentication.
HTTP method
GET
POST
Required user role
See Required Enterprise Manager permissions.
Request parameters
| Location | URL Parameter Name | Required | Example |
|---|---|---|---|
|
URL |
host [string] |
Yes |
computer.network.net |
|
Header (only required when using Active Directory or OpenID Connect authentication) |
When using Active Directory authentication: user@domain:password converted to base 64 [string] When using OpenID Connect authentication: api-token:personal-access-token converted to base 64 [string] Information noteThis login method requires you to be in possession of a Personal Access Token generated in Enterprise Manager. For details, see Setting up OpenID Connect authentication.
|
Yes |
- |
Response header
| URL Param Name | Description |
|---|---|
| EnterpriseManager.APISessionID |
Identifier to be used to get authorization to run API functions on Enterprise Manager |
cURL example
Active Directory request
curl -i -k --header "Authorization: Basic cWFAcWE6cWE=" https://computer.network.net/attunityenterprisemanager/api/v1/login
OpenID Connect request
curl -i -k --header "Authorization: Basic Z3dDN2FleHJJVDdpZ0hBRjI2dkxCTDJIUi9JTHJKYXFkZT" https://computer.network.net/attunityenterprisemanager/api/v1/login
Response
HTTP/1.1 200 OK
Content-Length: 0
Content-Type: text/html
Server: Microsoft-HTTPAPI/2.0
EnterpriseManager.APISessionID: J3cKzWIbi_w6Fr1G-tO03Q
Date: Mon, 26 Dec 2016 17:02:01 GMT
Error response
| HTTP Code | Enterprise Manager Code | Text | Description |
|---|---|---|---|
|
401 |
UNAUTHORIZED_REQUEST | Unauthorized Request. |
The request was not authorized. |