start proxy access

Register an exact-host private service sign-in using a dedicated trusted relay credential. The browser cannot supply the policy or callback host.

POST /api/v1/access/requests

start proxy access

Python

import requests

url = "https://platform.ankra.app/api/v1/access/requests"

payload = {
    "policy": {
        "hostname": "<string>",
        "organisation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "roles": ["<string>"]
    },
    "challenge": "<string>"
}
headers = {
    "X-Ankra-Access-Token": "<x-ankra-access-token>",
    "X-Ankra-Internal-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

200

{
  "authorize_path": "<string>"
}

Authorizations

X-Ankra-Internal-Token · string · header · required

Platform service-to-service credential held by Ankra-operated relays, accepting current and next values during rotation. Not issued to customers.

Headers

X-Ankra-Access-Token · string · required

Body

application/json

policy · object · required

Show child attributes

challenge · string · required

Response

200

application/json

Sign-in continuation

authorize_path · string · required