다수 그룹 삭제 (API)

Okta 그룹 다수 삭제 가이드

triangle-exclamation
circle-info

다수의 그룹 삭제는 Okta 관리 콘솔 UI에서 지원하지 않는 기능으로 API를 통해 진행하여야 합니다. API 활용을 위해 아래의 사전 작업이 필요합니다.

  • Rockstar 설치 : 그룹 정보 CSV 파일 추출 용도

  • Postman 구성 : CSV 파일을 통한 API 활용 용도


1. 사전 구성 사항

1) Postman App 설치 및 환경 설정 (필수)

2) Rockstar Browser 확장 프로그램

circle-info

Rockstar는 Okta에서 제공하는 공식 프로그램이 아닙니다.

  • 비신뢰 브라우저 확장 프로그램에 대한 내부 보안 절차 또는 검토가 필요할 수 있습니다.

Rockstar의 기능 문의 및 이슈사항에 대하여 Okta 서포트팀에서 지원하지 않습니다.

  • 커뮤니티를 통해 개발된 오픈소스의 확장 프로그램이며, 해당 github 페이지arrow-up-right에서 상제 정보를 확인할 수 있습니다.

  • "rockstar" 설치 이후, Okta Admin 관리 콘솔 접속

    • "Directory" → "Groups"으로 이동

      "Export Groups" 기능을 통해 모든 그룹 정보를 추출합니다.

  • 추출한 그룹 CSV 파일을 실행 후, 필터 기능을 통해 삭제하고자 하는 "그룹명"을 선택합니다.

추출한 CSV 파일에 "한글명" 그룹은 한글 글자가 깨짐 현상이 발생합니다.

  • 해당 깨짐 현상은 CSV 파일 인코딩 format의 구조적인 문제로 "UTF-8" 문자 인코딩 형태로 기본 제공되기 때문에 한글이 깨지는 이슈이며, "ANSI" 인코딩 변환 작업이 별도로 필요합니다.

    • CSV 파일의 UTF-8 변환 가이드를 참고하셔서 추출한 CSV 파일의 "ANSI" 문자 인코딩으로 저장하시면 한글 깨짐의 CSV파일의 그룹명 한글 정보가 정상적으로 확인됩니다.

  • API를 통해 사용할 항목은 그룹의 ID 입니다. 그 외 나머지 항목은 제거합니다.

  • 그룹 ID 항목의 필드 값을 "groupId" 로 변경 합니다. (대소문자 구분)

  • 변경 완료 후 상단의 "파일"을 통해 "저장"합니다.

circle-exclamation

2. Postman API 구성

  • Okta API 항목 중, "Delete a Group"의 Request 쿼리의 그룹 정보인 "groupId"를 변수로 변경하여 저장(Save)합니다.

  • Postman 우측하단의 "Runner"를 실행합니다.

  • "Delete a Group"을 Run order 중앙으로 드래그합니다.

  • "Delete a Group" 항목만 체크 후 "Select File"을 클릭합니다.

  • 삭제할 그룹ID의 CSV 파일을 선택 후 "열기"를 선택합니다.

  • 삭제할 그룹의 수량이 맞는지 확인 후 "Run Okta Admin Management"를 클릭합니다.

  • 정상적으로 삭제 될 경우, "204 No Content" 응답을 받습니다.

  • 관리자 콘솔에서 System log를 통해 삭제된 그룹 로그를 확인할 수 있습니다.

Last updated