본문으로 건너뛰기
블로그로 돌아가기
AI

클로드 Admin API 사용자 로그아웃 베타: 바뀐 점과 지금 할 일

클로드 Admin API 사용자 로그아웃이 2026년 11월 5일 Enterprise 베타로 추가됐다. 요청 방법, 끊기는 것과 남는 것, 확인 방법을 정리했다.

5분 소요AI
클로드 Admin API클로드 엔터프라이즈 관리클로드 API 릴리스 노트사용자 로그아웃Anthropic
클로드 Admin API 사용자 로그아웃 베타: 바뀐 점과 지금 할 일

클로드 Admin API 사용자 로그아웃은 2026년 11월 5일 베타로 추가된 기능으로, Claude Enterprise 관리자가 API 요청 한 번으로 직원 한 명의 로그인을 모든 브라우저와 기기에서 끊는다. 퇴사자나 노트북 분실 사고가 생기면 보안 담당자는 계정을 지우지 않고도 로그인 상태만 끊을 수 있는지 다시 정해야 한다. 호텔 프런트가 분실된 카드키를 무효로 하고 새 키를 받게 하는 것과 비슷하다. 다만 카드키만 막을 뿐 객실에 두고 간 짐까지 치워 주지는 않듯, 이 요청도 끊는 것과 남는 것이 나뉘어 있다.

무엇이 바뀌었나 2026년 11월 5일 Anthropic이 Claude Enterprise 멤버를 모든 기기에서 로그아웃시키는 Admin API 엔드포인트를 베타로 추가했다.

누가 영향을 받나 Claude Enterprise(claude.ai) 조직의 보안·IT 관리자다. API로만 쓰는 Claude Platform 조직은 대상이 아니다.

지금 할 일 write:members 권한의 Admin API 키를 준비하고, 퇴사·기기 분실 절차에 로그아웃 요청과 API 키 삭제를 함께 넣는다.

클로드 Admin API 사용자 로그아웃, 무엇이 바뀌었나

Anthropic은 Claude Platform 릴리스 노트의 11월 5일 항목에서 Claude Enterprise 멤버용 로그아웃 엔드포인트를 베타로 공개했다. 주소는 POST /v1/organizations/users/{user_id}/sign_out이고, 사용자 관리 문서에 따르면 멤버를 조직에서 빼지 않고 모든 브라우저와 기기에서 로그아웃시킨다.

요청에는 본문이 없고 헤더 세 개가 필요하다. 관리자 키를 x-api-key에, API 버전을 anthropic-version에, 베타 값 admin-user-sign-out-2026-10-08을 anthropic-beta에 넣는다. 베타 헤더가 없으면 400 오류가 난다. 성공하면 200과 함께 해당 멤버의 정보가 돌아오며 역할 같은 값은 그대로다.

클로드 Admin API 사용자 로그아웃 순서: 멤버 ID 찾기, sign_out 요청 보내기, 감사 로그 확인
로그아웃 요청의 처리 순서

사용자 로그아웃 요청 보내는 순서

  1. claude.ai 조직 설정의 API 항목에서 write:members 범위를 가진 Admin API 키를 만든다. 사용자 관리 문서에 따르면 연결된 조직마다 그 조직의 Primary owner가 만든 키가 따로 필요하다. 이메일로 멤버를 찾으려면 read:members도 함께 고른다.
  2. List users로 /v1/organizations/users?email=jane@example.com을 조회해 user_로 시작하는 id를 얻는다. 이메일 일치는 대소문자를 가리지 않고 jane+hiring@example.com 같은 변형도 잡으므로 이름과 이메일이 맞는 사람인지 본다.
  3. POST /v1/organizations/users/{user_id}/sign_out을 위 헤더와 함께 보낸다.
  4. 200이 돌아오면 아래 확인 절차대로 감사 로그에 기록이 남았는지 본다.

운영에 넣기 전에 시험용 멤버 계정으로 한 번 해 보는 방법을 권한다. 그 계정을 claude.ai와 클로드 코드에 로그인해 둔 뒤 요청을 보내고, 두 곳 모두 다시 로그인을 요구하는지와 감사 로그에 기록이 남았는지를 본다. 공식 문서가 예고한 대로라면 토큰은 최대 한 시간까지 걸릴 수 있으므로 앱은 시간을 두고 확인한다. 이 요청은 다시 보내도 안전하다. 끊을 것이 남아 있지 않아도 200이 돌아온다. 실패하면 상태 코드로 원인을 구분한다.

상태뜻
400 cannot_sign_out_primary_owner대상이 Primary owner다
400 organization_not_enrolled_in_beta우리 조직에는 아직 이 베타가 열리지 않았다
403키에 write:members가 없다
404그 ID의 멤버가 조직에 없다
429Admin API 공용 한도(분당 100회)를 넘었다. retry-after만큼 기다린다
503필요한 서비스가 일시 중단됐다. 이미 끊은 것은 유지되고, 200이 올 때까지 재시도한다

로그아웃으로 끊기는 것과 남는 것

이 요청이 끊는 것은 세 가지다. 그 사람 계정의 모든 로그인 세션, 신뢰한 기기(다시 등록해야 한다), 그리고 이 조직용으로 발급된 OAuth 토큰이다. 클로드 코드 같은 앱은 다시 로그인해야 하고, 토큰은 대체로 즉시, 늦어도 한 시간 안에 멈춘다고 공식 문서는 설명한다.

세션과 신뢰 기기는 개인 계정에 속하기 때문에 그 사람의 다른 조직이나 개인 요금제 로그인도 함께 풀린다. OAuth 토큰만 이 조직에 한정된다.

클로드 Admin API 사용자 로그아웃으로 끊기는 로그인 세션과 남는 API 키를 나눈 비교
로그아웃 요청이 끊는 것과 그대로 두는 것

반대로 문서가 끊지 않는다고 밝힌 것은 아래와 같다.

남는 것할 일
API 키(그 사람이 만든 Admin API 키 포함)claude.ai 조직 설정 API의 Keys에서 직접 삭제한다
다른 조직의 OAuth 토큰그 조직의 키로 요청을 따로 보낸다
클로드 코드 클라우드 세션과 루틴계속 실행되며, 새 자격 증명으로 이어지기 전에 작업이 실패할 수 있다
Cowork에 연결된 컴퓨터연결이 유지된다
진행 중인 로그인요청 뒤 최대 5분 안에 끝날 수 있다

그래서 퇴사자를 막는 목적이라면 로그아웃만으로는 부족하다. 로그아웃 뒤에도 멤버는 바로 다시 로그인할 수 있기 때문에, 같은 문서의 Remove user(DELETE /v1/organizations/users/{user_id})로 멤버를 제거하고 인증 공급자(IdP) 계정도 비활성화한다. 비활성화만 하고 멤버 목록에 남기면, IdP 계정이 살아 있는 한 자동 프로비저닝이 다음 로그인 때 다시 추가할 수 있다고 문서는 경고한다. Primary owner는 이 API로 로그아웃시킬 수 없어 본인이 claude.ai 계정 설정에서 직접 한다.

제대로 끊겼는지 확인하는 방법

성공 여부는 200 응답이 아니라 기록으로 본다. 공식 문서에 따르면 완료된 로그아웃은 claude.ai 감사 로그 내보내기에 org_user_trusted_devices_revoked로 남고, Compliance API를 쓰면 활동 피드에서 끊긴 기기와 세션 수를 볼 수 있다. 중간에 멈춘 요청은 감사 로그가 아니라 활동 피드에 completed가 false로 나온다. 푸시 알림 등록 삭제는 비동기라 200이 이 단계의 완료를 보장하지 않는다.

요청 뒤에 그 사람의 로그인 기록이 감사 로그에 보이거나 클로드 코드 같은 앱을 쓰던 중이었다면 5분 뒤에 같은 요청을 다시 보낸다. 다른 관리 기능과의 관계가 궁금하면 클로드 인퍼런스 훅(프롬프트를 보내기 전에 막는 기능)과 클로드 API OpenTelemetry 내보내기(사용 기록을 모니터링 도구로 보내는 기능)도 함께 보면 된다.

앞으로 확인할 점

이 엔드포인트는 릴리스 노트상 베타이고, 조직에 따라 organization_not_enrolled_in_beta 오류가 날 수 있다. 베타 헤더 값에 날짜가 들어 있으므로 정식 전환 때 값이 바뀔 수 있어 운영 스크립트에 넣을 때는 릴리스 노트를 정기적으로 확인한다. 직원 개인정보와 접속 기록을 다루므로 한국 법인은 로그아웃 요청 기록의 보관과 접근 권한도 내부 규정에 맞춰 둔다.

자주 묻는 질문

로그아웃시키면 그 직원의 대화 기록이나 좌석도 사라지나요?

사라지지 않는다. 멤버는 조직에 남고 역할도 그대로이며 바로 다시 로그인할 수 있다. 좌석을 돌려받으려면 Remove user를 써야 한다.

이메일만 알면 로그아웃시킬 수 있나요?

sign_out 요청은 user_로 시작하는 ID가 필요하다. 먼저 List users에 이메일을 넣어 ID를 조회한다.

클로드 코드에서 쓰던 토큰은 바로 멈추나요?

공식 문서는 토큰이 대체로 즉시, 늦어도 한 시간 안에 멈춘다고 설명한다. 클라우드에서 돌던 클로드 코드 세션은 계속 실행되므로 따로 확인해야 한다.

이 글이 도움이 되었다면 공유해주세요

최신 인사이트

관련 프로젝트

새 글을 이메일로 받아보세요

마케팅, 분석, 개발 인사이트를 정리해서 보내드려요.