인증 토큰

언어:

POST 요청을 전송하여 액세스 서비스에서 비지속적 로그인 토큰을 얻습니다. 이 비지속적 로그인 토큰은 기타 모든 서비스가 ID 자격 증명으로 사용할 수 있습니다. 비지속적 로그인 토큰은 사용자의 세션 시간 초과 등록 정보에 의해 설정된 시간 초과 기간 이후 무효화됩니다. 기본값은 대개 15분입니다. DELETE 요청은 비지속적 로그인 토큰을 로그아웃한 후 무효화하는 데 사용될 수 있습니다.

이 비지속적 로그인 토큰은 이전 인증 세션 ID와 동등합니다. RESTful API 버전 2와 RESTful API 버전 1에서 모두 지원됩니다. 이는 ID가 만들어지고 클러스터 피어 간에 동기화되지 않는 클러스터 노드와 관련이 있습니다.

사용자는 RESTful API에 액세스하는 데 필요한 지속적 토큰을 만들 수도 있습니다. 지속적 토큰 만들기는 RESTful API 버전 2 이상에서만 지원됩니다. 지속적 토큰은 클러스터 피어 간에 동기화되므로 하나의 클러스터 노드에서 만들어져서 다른 클러스터 노드와 통신하는 데 사용될 수 있습니다. RESTful API 사용자 서비스를 참조하십시오.

비지속적 로그인 토큰 만들기

POST 요청은 새로운 비지속적 로그인 토큰을 요청합니다. 성공 시 HTTP 상태 201이 사용 가능한 RESTful API 서비스 목록을 포함하는 단일 등록 정보 access가 있는 JSON 객체와 함께 반환됩니다. 선택적 등록 정보인 name은 토큰의 이름을 설정하는 데 사용할 수 있습니다.

만들기 요청 예:

POST /api/access/v2 HTTP/1.1
Host: zfs-storage.example.com:215
X-Auth-User: root
X-Auth-Key: password-xxx

성공한 요청은 HTTP 상태 201(Created)과 함께 X-Auth-Session HTTP 헤더를 통해 비지속적 로그인 토큰을 반환합니다. 응답 본문은 이 로그인을 통해 액세스할 수 있는 서비스 목록을 포함합니다.

응답 헤더:

HTTP/1.1 201 Created
X-Auth-Session: puPnHZKgSrUmXqYzOwFCrGcLOGwPODj
X-Auth-Name: REST-YG02oRod
Content-Type: application/json
Content-Length: 378
X-Zfssa-Access-Api: 1.0

{
    "access": {
        "services":[{
            ...
        }]
    }
}

비지속적 로그인 토큰 로그아웃 및 삭제

비어 있는 DELETE는 비지속적 로그인 토큰 로그아웃 및 무효화 요청을 전송합니다.

로그아웃 요청 예:

DELETE /api/access/v2 HTTP/1.1
X-Auth-Session: puPnHZKgSrUmXqYzOwFCrGcLOGwPODj

결과 예:

HTTP/1.1 204 No Content
X-Zfssa-Access-Api: 1.0