사용자 계정과 비활성 상태 관리

작업 공간의 탐색 사이드바에서 Account > Settings를 열고 Platform Settings > Users를 선택합니다. 사용자별 식별자, 소속과 특성을 확인할 수 있습니다.

사용자 특성에 따라 행을 구분하는 방법은 세분화된 접근 정책을 참조합니다.

첫 로그인 전 사전 등록

사전 등록 권한이 있는 플랫폼 관리자는 사용자가 처음 로그인하기 전에 계정을 준비할 수 있습니다. 사용자 이름, 그룹 소속, 조직과 보안 표지 접근 등을 미리 부여합니다.

사전 등록한 사용자 이름은 실제 로그인 사용자 이름과 정확히 같아야 합니다. 다르면 미리 구성한 접근이 로그인 사용자에게 연결되지 않습니다.

30일 비활성과 토큰

30일 동안 성공한 로그인이 없으면 계정은 자동으로 비활성 상태가 됩니다. 비활성 계정은 일반 계정처럼 남아 있지만, 비활성 상태인 동안 그 계정의 모든 토큰이 유효하지 않습니다.

사용자가 다시 로그인에 성공하면 관리자 조치 없이 활성 상태로 돌아가며, 계정 비활성화 때문에 중지됐던 토큰도 다시 사용할 수 있게 됩니다. 이 상태 변화가 토큰의 별도 만료 시각을 연장하거나 영구 폐기를 취소하지는 않습니다.

특정 Foundry 그룹이나 인증 realm의 사용자를 비활성 처리에서 제외할 수 있습니다. 필요한 제외 설정은 Palantir 담당자에게 문의합니다.

로그인할 때 Your account has been locked. Contact your support person to unlock it, then try again.이라는 메시지가 표시되면 Palantir 담당자에게 계정 잠금 해제를 요청합니다.

삭제된 계정 복원

Your account has been disabled 오류는 사용자 계정이 삭제되었음을 뜻합니다. 조직의 Manage membership 권한이 있는 관리자는 삭제된 사용자를 찾아 외부 사용자 계정을 복원할 수 있습니다.

아래 Bash 명령은 관리자가 직접 실행할 API 호출 형식입니다. FOUNDRY_URL에는 플랫폼 인스턴스의 기본 URL, TOKEN에는 해당 관리 권한이 있는 토큰을 설정합니다. 조회에는 실제 PAGE_SIZE와 PAGE_START_TOKEN, 복원에는 정확한 USER_ID를 사용합니다. 셸 내장 printf와 표준 입력으로 인증 헤더를 전달하므로 토큰을 curl의 명령행 인수에 넣지 않습니다. 계정 복원은 기존 사용자 접근을 되살리는 변경이므로 대상 사용자를 확인한 뒤 수행합니다.

사용자 ID를 모르면 getDeletedUsers로 찾습니다. ID를 이미 알고 있다면 이 조회는 생략할 수 있습니다. 페이지 크기의 최댓값은 1,000입니다.

삭제된 사용자 ID는 사용자 목록 API에 include=DELETED를 지정해서도 조회할 수 있습니다. getDeletedUsers 관리 API는 다음 형식으로 호출합니다.

printf 'Authorization: Bearer %s\n' "$TOKEN" | curl --fail-with-body --get \
  -H @- \
  --data-urlencode "pageSize=$PAGE_SIZE" \
  --data-urlencode "pageToken=$PAGE_START_TOKEN" \
  "$FOUNDRY_URL/multipass/api/administration/users/deleted"

정확한 사용자 ID를 확인한 뒤 undeleteExternalUser를 호출합니다.

printf 'Authorization: Bearer %s\n' "$TOKEN" | curl --fail-with-body -X POST \
  -H @- \
  "$FOUNDRY_URL/multipass/api/administration/users/$USER_ID/undelete/external"