다수 그룹 삭제 (API)
Okta 그룹 다수 삭제 가이드
삭제된 그룹은 다시 원복 할 수 없습니다! 꼭 작업하기 전 삭제될 그룹에 대하여 영향성 검토를 하시기 바랍니다.
Application 권한/라이선스 구성 여부, Group Push, Group Rule, Admin role과 Group Owner 구성 여부 등
다수의 그룹 삭제는 Okta 관리 콘솔 UI에서 지원하지 않는 기능으로 API를 통해 진행하여야 합니다. API 활용을 위해 아래의 사전 작업이 필요합니다.
Rockstar 설치 : 그룹 정보 CSV 파일 추출 용도
Postman 구성 : CSV 파일을 통한 API 활용 용도
1. 사전 구성 사항
1) Postman App 설치 및 환경 설정 (필수)
Postman App 설치와 Okta API 테스트 가이드는 아래 링크를 참고 바랍니다.
Okta Developer : Test the Okta REST APIs with Postman
2) Rockstar Browser 확장 프로그램
Rockstar는 Okta에서 제공하는 공식 프로그램이 아닙니다.
비신뢰 브라우저 확장 프로그램에 대한 내부 보안 절차 또는 검토가 필요할 수 있습니다.
Rockstar의 기능 문의 및 이슈사항에 대하여 Okta 서포트팀에서 지원하지 않습니다.
커뮤니티를 통해 개발된 오픈소스의 확장 프로그램이며, 해당 github 페이지에서 상제 정보를 확인할 수 있습니다.
크롬 웹스토어 : "rockstar" 확장 프로그램 연결
"Chrome에 추가" 선택
"rockstar" 설치 이후, Okta Admin 관리 콘솔 접속
"Directory" → "Groups"으로 이동
"Export Groups" 기능을 통해 모든 그룹 정보를 추출합니다.
추출한 그룹 CSV 파일을 실행 후, 필터 기능을 통해 삭제하고자 하는 "그룹명"을 선택합니다.
추출한 CSV 파일에 "한글명" 그룹은 한글 글자가 깨짐 현상이 발생합니다.
해당 깨짐 현상은 CSV 파일 인코딩 format의 구조적인 문제로 "UTF-8" 문자 인코딩 형태로 기본 제공되기 때문에 한글이 깨지는 이슈이며, "ANSI" 인코딩 변환 작업이 별도로 필요합니다.
CSV 파일의 UTF-8 변환 가이드를 참고하셔서 추출한 CSV 파일의 "ANSI" 문자 인코딩으로 저장하시면 한글 깨짐의 CSV파일의 그룹명 한글 정보가 정상적으로 확인됩니다.
API를 통해 사용할 항목은 그룹의 ID 입니다. 그 외 나머지 항목은 제거합니다.
그룹 ID 항목의 필드 값을 "groupId" 로 변경 합니다. (대소문자 구분)
변경 완료 후 상단의 "파일"을 통해 "저장"합니다.
최종 Postman을 통한 API 환경 구성과 Rockstar Browser 확장 프로그램을 통해 추출한 CSV 파일이 모두 준비가 되었다면 아래 가이드로 진행 하실 수 있습니다.
2. Postman API 구성
Okta API 항목 중, "Delete a Group"의 Request 쿼리의 그룹 정보인 "groupId"를 변수로 변경하여 저장(Save)합니다.
Okta developer API : Delete a group
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