Tiếp tục phiên tài khoản

POST

https://platform.verolabs.co

api

auth

mfa

resume

Tiếp tục phiên tài khoản

curl --request POST \
  --url https://platform.verolabs.co/api/auth/mfa/resume \
  --header 'X-Auth-Session-Token: <api-key>'

const options = {method: 'POST', headers: {'X-Auth-Session-Token': '<api-key>'}};

fetch('https://platform.verolabs.co/api/auth/mfa/resume', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.verolabs.co/api/auth/mfa/resume"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("X-Auth-Session-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

using RestSharp;


var options = new RestClientOptions("https://platform.verolabs.co/api/auth/mfa/resume");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-Auth-Session-Token", "<api-key>");
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://platform.verolabs.co/api/auth/mfa/resume");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "X-Auth-Session-Token: <api-key>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

{
  "status": "authenticated",
  "sessionToken": "<session-token>",
  "jwt": "<jwt>",
  "session": {
    "active": true,
    "authenticator_assurance_level": "aal1",
    "tokenized": "<jwt>"
  },
  "identity": null,
  "tokenizedSession": {
    "active": true,
    "authenticator_assurance_level": "aal1",
    "tokenized": "<jwt>"
  }
}

Dùng endpoint này khi bạn đã có sessionToken của tài khoản. Gửi token trong X-Auth-Session-Token, không cần body. Giá trị này là token phiên tài khoản, không phải JWT dùng cho REST API.

COOKIE_JAR="$(mktemp)"
chmod 600 "$COOKIE_JAR"
read -r -s -p "Token phiên: " SESSION_TOKEN
printf '\n'

AUTH_RESPONSE="$(curl --silent --show-error --fail-with-body \
  --request POST 'https://platform.verolabs.co/api/auth/mfa/resume' \
  --cookie-jar "$COOKIE_JAR" \
  --header "X-Auth-Session-Token: $SESSION_TOKEN")"
unset SESSION_TOKEN

printf '%s\n' "$AUTH_RESPONSE" | jq '{status, methods, expiresAt}'

Nếu status là authenticated, phản hồi chứa JWT để gọi REST API cần xác thực. Nếu status là mfa_required, phản hồi chưa có JWT. Giữ cookie jar và hoàn tất xác minh hai lớp bằng phương thức có trong methods. Dùng lại bước xác minh và lấy JWT trong quy trình đăng nhập bằng mật khẩu, với AUTH_BASE_URL="https://platform.verolabs.co". Xoá cookie jar khi hoàn tất xác thực. Thiếu token trả HTTP 401 với session_missing. Nếu phiên không còn hợp lệ, đăng nhập lại. Yêu cầu từ trình duyệt phải cùng origin với máy chủ xác thực.

Ủy quyền

X-Auth-Session-Token

string

header

bắt buộc

Token phiên tài khoản hiện có, được trả về trong sessionToken sau khi xác thực. Đây không phải Bearer JWT.

Phản hồi

Phiên đã xác thực kèm JWT, hoặc yêu cầu xác thực yếu tố thứ hai đang chờ. Kiểm tra status.

Option 1
Option 2

Kiểm tra status trong mọi phản hồi HTTP thành công. authenticated chứa JWT; mfa_required yêu cầu gọi POST /api/auth/mfa/verify với cookie từ phản hồi.

status

enum<string>

bắt buộc

Cho biết xác thực đã hoàn tất và JWT có thể được sử dụng.

Tùy chọn có sẵn:

authenticated

sessionToken

string

bắt buộc

Token phiên tài khoản. Giữ bí mật token này. Dùng để tiếp tục phiên; dùng jwt để xác thực REST API.

jwt

string

bắt buộc

Bearer JWT cho yêu cầu REST API cần xác thực. Gửi bằng Authorization: Bearer .

session

object

bắt buộc

Phiên đã xác thực và đang hoạt động.

Hide child attributes

session.id

string

Unique identifier for the record.

session.active

boolean

Indicates whether the session is active.

session.authenticated_at

string<date-time>

Timestamp when the session was authenticated.

session.expires_at

string<date-time>

Timestamp when the session expires.

session.devices

object[]

Devices associated with the authenticated session.

Hide child attributes

session.devices.ip_address

string

IP address reported for the session device.

session.devices.location

string

Location metadata reported for the session device.

session.devices.user_agent

string

User agent reported for the session device.

session.identity

object | null

Thông tin danh tính tài khoản của phiên đã xác thực, hoặc null nếu phản hồi không có danh tính.

Hide child attributes

session.identity.id

string

Unique identifier for the record.

session.identity.traits

object

Account attributes returned with the authenticated session.

session.tokenized

string

Bearer JWT issued for REST API calls.

session.authenticator_assurance_level

enum<string>

Mức xác thực của phiên: aal1 sau khi xác thực yếu tố thứ nhất; aal2 sau khi xác thực hai lớp thành công.

Tùy chọn có sẵn:

aal1,

aal2

identity

object | null

bắt buộc

Danh tính tài khoản, hoặc null nếu không có.

Hide child attributes

identity.id

string

Unique identifier for the record.

identity.traits

object

Account attributes returned with the authenticated session.

tokenizedSession

object

bắt buộc

Phiên đã xác thực chứa JWT trong trường tokenized.

Hide child attributes

tokenizedSession.id

string

Unique identifier for the record.

tokenizedSession.active

boolean

Indicates whether the session is active.

tokenizedSession.authenticated_at

string<date-time>

Timestamp when the session was authenticated.

tokenizedSession.expires_at

string<date-time>

Timestamp when the session expires.

tokenizedSession.devices

object[]

Devices associated with the authenticated session.

Hide child attributes

tokenizedSession.devices.ip_address

string

IP address reported for the session device.

tokenizedSession.devices.location

string

Location metadata reported for the session device.

tokenizedSession.devices.user_agent

string

User agent reported for the session device.

tokenizedSession.identity

object | null

Thông tin danh tính tài khoản của phiên đã xác thực, hoặc null nếu phản hồi không có danh tính.

Hide child attributes

tokenizedSession.identity.id

string

Unique identifier for the record.

tokenizedSession.identity.traits

object

Account attributes returned with the authenticated session.

tokenizedSession.tokenized

string

Bearer JWT issued for REST API calls.

tokenizedSession.authenticator_assurance_level

enum<string>

Mức xác thực của phiên: aal1 sau khi xác thực yếu tố thứ nhất; aal2 sau khi xác thực hai lớp thành công.

Tùy chọn có sẵn:

aal1,

aal2

Tiếp tục phiên tài khoản

curl --request POST \
  --url https://platform.verolabs.co/api/auth/mfa/resume \
  --header 'X-Auth-Session-Token: <api-key>'

const options = {method: 'POST', headers: {'X-Auth-Session-Token': '<api-key>'}};

fetch('https://platform.verolabs.co/api/auth/mfa/resume', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.verolabs.co/api/auth/mfa/resume"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("X-Auth-Session-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

using RestSharp;


var options = new RestClientOptions("https://platform.verolabs.co/api/auth/mfa/resume");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-Auth-Session-Token", "<api-key>");
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://platform.verolabs.co/api/auth/mfa/resume");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "X-Auth-Session-Token: <api-key>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

{
  "status": "authenticated",
  "sessionToken": "<session-token>",
  "jwt": "<jwt>",
  "session": {
    "active": true,
    "authenticator_assurance_level": "aal1",
    "tokenized": "<jwt>"
  },
  "identity": null,
  "tokenizedSession": {
    "active": true,
    "authenticator_assurance_level": "aal1",
    "tokenized": "<jwt>"
  }
}

Tổng quan

Integrations

Authentication

REST API

Streaming API

FIX API

Tiếp tục phiên tài khoản

Ủy quyền

Phản hồi