사용자를 제거하는 작업 만들기

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 4분

    • SaaS 애플리케이션에서 사용자 계정을 비활성화하거나 삭제하는 작업을 만듭니다.

    시작하기 전에

    기존 ServiceNow® Integration Hub 스포크를 사용하는 경우 사용자를 만드는 대신 사용할 수 있는 사용자를 제거하는 작업이 있는지 확인합니다.

    필요한 역할: flow_designer 또는 admin

    이 태스크 정보

    이 작업은 사용하지 않는 구독을 회수하여 회사의 소프트웨어 비용을 줄이는 데 사용됩니다.

    프로시저

    1. 다음으로 이동 모두 > 플로우 디자이너 > 디자이너.
    2. New(새로 만들기)를 클릭한 다음 Action(작업)을 선택합니다.
    3. 양식의 필드에 내용을 입력합니다.
      표 1. 작업 속성 양식
      필드 값
      이름 선택한 이름입니다. 예를 들면 Remove User(사용자 제거)입니다.
      다음에서 접근 가능 모든 애플리케이션 범위입니다.
      범주 이 필드를 비워 둡니다.
      보호 없음.
      애플리케이션 SaaS 애플리케이션과 통합할 스포크 앱입니다. 이 스포크는 기존 Integration Hub 스포크 또는 사용자가 생성한 새 스포크일 수 있습니다.
      플로우 내 주석 이 필드를 비워 둡니다.
      설명 선택에 대한 설명입니다.
    4. 제출을 클릭합니다.
    5. Action Outline의 Inputs(입력) 섹션에서 Create Input(입력 생성)을 클릭합니다.
    6. 사용자 ID 입력을 추가합니다.

      이것이 작업이 삭제할 사용자의 사용자 ID를 가져오는 방법입니다.

      표 2. 입력
      레이블 이름 유형 필수
      사용자 ID userID 문자열 예
    7. 작업 중인 API가 요청에 대해 사용자 인증을 요구하는 경우 인증을 위한 입력을 추가합니다.
      일반적인 사용자 인증 입력의 예로는 관리자 사용자 ID 및 사이트 이름이 있습니다. 선택한 API에 대한 설명서를 참조하여 특정 사례의 사용자 인증 요구 사항에 대해 알아봅니다. API에 액세스 토큰이 필요한 경우 자격 증명 값 변수가 나중에 자동으로 생성되므로 입력으로 추가할 필요가 없습니다.

      하위 플로우에서 완료된 작업을 사용할 때 이러한 입력으로 전달할 값을 정의합니다.

    8. 작업 개요에 SOAP 단계 또는 REST 단계를 추가합니다.
      선택은 통합하는 SaaS 애플리케이션의 API에 따라 달라집니다.
    9. SOAP를 선택한 경우 표시된 대로 양식을 채웁니다.
      표 3. SOAP 단계 양식
      필드 값
      연결 상세 정보
      연결 연결 별칭을 사용합니다.
      연결 별칭 통합 프로파일을 생성할 때 생성한 연결 별칭입니다. 아직 통합 프로파일을 생성하지 않은 경우 단계에 따라 연결 별칭을 사용하여 사용자 지정 통합 프로파일을 생성합니다.
      엔드포인트 연결 별칭을 선택하면 이 값이 자동으로 채워집니다. 별칭에 연결된 HTTP 연결 기록의 연결 URL로 설정됩니다.
      요청 상세 정보
      빌드 봉투 수동으로.
      SOAP 동작 사용자 삭제 또는 비활성화를 위한 API 요청입니다. 선택한 API에 대한 설명서를 참조하여 적절한 요청을 선택합니다.
      SOAP 봉투 사용자를 삭제하라는 XML 요청 메시지입니다. XML 요청 메시지를 작성하는 방법을 알아보려면 선택한 API에 대한 설명서를 참조하십시오. 일반적으로 헤더에는 사용자 인증을 위한 입력 변수와 자격 증명 값 변수가 액세스 토큰으로 있어야 합니다. 본문에는 사용자 삭제 요청과 사용자 ID 입력이 포함되어야 합니다.
      주:
      SOAP 봉투의 예는 구독 회수 하위 플로우에서 Webex 사용되는 사용자 제거 조치를 참조하십시오.
    10. REST를 선택한 경우 표시된 대로 양식을 채웁니다.
      표 4. REST 단계 양식
      필드 값
      연결 상세 정보
      연결 연결 별칭을 사용합니다.
      연결 별칭 통합 프로파일을 생성할 때 생성한 연결 별칭입니다. 아직 통합 프로파일을 생성하지 않은 경우 단계에 따라 연결 별칭을 사용하여 사용자 지정 통합 프로파일을 생성합니다.
      기본 URL 연결 별칭을 선택하면 이 값이 자동으로 채워집니다. 별칭에 연결된 HTTP 연결 기록의 연결 URL로 설정됩니다.
      요청 상세 정보
      빌드 요청 수동으로.
      리소스 경로 자원의 경로입니다. 이 값은 기본 URL에 추가됩니다. 리소스 경로를 구성하는 방법을 알아보려면 작업 중인 API에 대한 설명서를 참조하세요.
      HTTP 메서드 삭제.
      쿼리 매개 변수 사용자 ID에 대한 매개변수를 추가합니다. 값을 사용자 ID 입력으로 설정합니다.
    11. 오류 처리를 위해 작업 개요에 스크립트 단계를 추가합니다.
      1. [Required Runtime]에서 [Instance]를 선택합니다.
      2. 입력 변수를 생성합니다.
        표 5. 입력 변수
        이름 값
        response SOAP 또는 REST 단계의 응답 본문 출력
        status_code SOAP 또는 REST 단계의 상태 코드 출력
      3. 출력 변수를 생성합니다.
        표 6. 출력 변수
        레이블 이름 유형 필수
        status status 선택 예
        error_message error_message 문자열 예
      4. 스크립트 필드에서 상태 및 오류 메시지 출력에 값을 할당하는 스크립트를 작성합니다.
        • status_code 입력을 사용하여 오류가 있는지 확인합니다. 오류가 있는 경우 상태 출력을 오류 로 설정하고 오류가 없는 경우 성공 으로 설정합니다.
        • 오류가 있는 경우 응답 입력을 사용하여 오류의 종류에 대한 정보를 가져옵니다. 사용자가 무엇이 잘못되었는지 이해할 수 있도록 오류 메시지 출력을 오류에 대한 설명으로 설정합니다.
    12. Action Outline(작업 개요)에서 Outputs(출력)를 클릭합니다.
    13. 출력 변수를 생성합니다.
      표 7. 출력 변수
      레이블 이름 유형 필수
      상태 status 선택 아니요
      오류 메시지 error_message 문자열 아니요
    14. 출력 변수에 값을 할당합니다.
      표 8. 출력 변수
      레이블 값
      상태 스크립트 단계의 상태 출력 변수
      오류 메시지 스크립트 단계에서 출력 변수 error_message
    15. 작업을 테스트하려면 테스트를 클릭합니다.
      1. 오류에 대한 자세한 내용은 테스트 결과 및 시스템 로그를 참조하십시오.
        시스템 로그를 보려면 다음으로 이동합니다. 시스템 로그 > 시스템 로그 > 모두.
      2. 작업에 오류가 있는 경우 올바른 엔드포인트를 사용하고 있는지, API 요청이 예상대로 구성되어 있는지 확인합니다.
      주:
      테스트할 때 이 작업은 사용자를 비활성화한다는 점에 유의하십시오. 하위 프로덕션 환경에서 이 작업을 테스트합니다. 프로덕션 환경만 사용할 수 있는 경우 테스트를 위해 가짜 사용자를 만들 수 있습니다.
    16. 작업이 예상대로 작동하는지 확인한 후 게시를 클릭합니다.