DocuSign와의 통합

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기7분

    • 인스턴스를 DocuSign 서비스와 통합 ServiceNow 하여 소프트웨어 구독을 추적하고 미사용 라이센스를 회수할 수 있습니다.

    DocuSign 리셀러를 통해 구매한 상품은 표준 결제 시스템에 반영 DocuSign 되지 않습니다. 따라서 에서 사용할 수 ServiceNow있는 봉투 사용에 대한 값은 API를 통해 반환되지 않습니다.

    주:
    DocuSign 사용자가 사용자 API에서 lastLogin 필드를 제거했습니다. 따라서 사용자의 마지막 활동은 이 통합의 일부로 추적되지 않습니다.

    서비스에 대한 DocuSign 자세한 내용은 DocuSign 개발자 사이트를 참조하세요.

    애플리케이션 등록 DocuSign

    관리 포털을 DocuSign 통해 애플리케이션을 등록합니다 DocuSign .

    시작하기 전에

    DocuSign 필요한 역할: admin

    프로시저

    1. 데모(비프로덕션) 계정에 로그인합니다 DocuSign .
    2. 프로필 사진을 선택합니다.
    3. 내 앱 및 키를 선택합니다.
      • 프로덕션에서 사용할 준비가 된 이전 통합의 API 통합 키가 이미 있는 경우 33단계로 건너뜁니다.
      • 클라이언트 비밀을 저장하지 않은 경우 새 암호를 생성해야 합니다.
    4. 왼쪽 창에서 통합 > 앱 및 키레이블이 표시됩니다.
    5. Apps and Integration Keys(앱 및 통합 키) 섹션에서 ADD APP AND INTEGRATION KEY(앱 및 통합 키 추가)를 선택합니다.
    6. 통합 키 추가 양식에서 앱 이름 필드에 이름을 입력하고앱 생성을 선택합니다.
    7. Additional Settings(추가 설정) 섹션의 Redirect URIs(리디렉션 URI) 필드에서 ADD URI(URI 추가)를 선택합니다.
    8. https://oauth.pstmn.io/v1/browser-callback 추가합니다.
    9. URI 추가를 다시 선택하고 https:// ServiceNow instance.service-now.com/oauth_redirect.do 를 추가합니다.
    10. 비밀 키 추가를 선택합니다.
      통합 키(클라이언트 ID)와 비밀 키(클라이언트 비밀)를 안전한 위치에 저장하면 나중에 Postman 앱에서 사용하고 인스턴스의 통합 키(클라이언트 ID)에서 사용할 수 있습니다 ServiceNow .
    11. 저장을 선택합니다.
    12. 최신 버전의 Postman 앱을 다운로드하고 로그인을 건너뜁니다.
    13. 선택 새 컬렉션 을 클릭하고 컬렉션에 이름을 제공합니다.
    14. 권한 부여 탭을 선택합니다.
    15. 유형 목록 메뉴에서 OAuth 2.0을 선택합니다.
    16. 이름을 입력하고 구성 옵션 탭의 필드를 완성하여 토큰을 만듭니다.
      필드 값
      콜백 URL https://oauth.pstmn.io/v1/browser-callback
      인증 URL https://account-d.docusign.com/oauth/auth
      접근 토큰 URL https://account-d.docusign.com/oauth/token
      클라이언트 ID 10단계에서 만든 데모 계정의 통합 키 DocuSign 입니다.
      클라이언트 비밀 데모 계정의 비밀 키 DocuSign10단계.
    17. Get New Access Token(새 액세스 토큰 가져오기)을 선택합니다.
      (으)로 리디렉션됩니다 DocuSign.
    18. 수락을 선택합니다.
    19. 액세스 토큰이 수집되고 인증이 완료되면 나중에 사용할 수 있도록 액세스 토큰을 복사합니다.
    20. 새 요청을 선택하여 계정 ID에 대한 GET 요청을 만듭니다.
    21. GET 필드에 URL을 https://account-d.docusign.com/oauth/userinfo 으로 입력합니다.
    22. Headers(헤더) 탭의 KEY(키)에서 Authorization(권한 부여)을 선택하고 Value(값) 아래에 Bearer<인증 중에 복사한 액세스 토큰> 을 입력합니다.
    23. 보내기를 선택하고 요청이 완료되었는지 확인합니다.
      계정 ID가 응답 본문에 표시됩니다.
    24. GET 요청을 복제합니다.
      Headers(헤더)에서 권한 부여 키와 값을 복사합니다.
    25. GET 필드의 URL을 https://demo.docusign.net/restapi/v2/accounts/<account-id>/users로 업데이트합니다.
      여기서 account-id 는 이전 요청에서 저장한 ID입니다.
    26. 20번 보내기 를 선택하여 20개의 API를 호출합니다.
      관리 포털을 통해 애플리케이션을 등록하려면 최소 20개의 API 호출을 DocuSign 호출해야 합니다.
    27. 관리 포털에서 DocuSign앱 및 통합 키로 이동합니다.
    28. 선택 작업 > API 대시보드 보기 응용 프로그램 옆에 있습니다.
    29. 20개의 API 호출이 모두 등록될 때까지 DocuSign 몇 분 정도 기다립니다.
    30. 다음으로 이동 통합 > 앱 및 키 을 클릭하고 검토를 위해 제출을 선택합니다.
      5-20분 후 신청서 검토가 완료됩니다. 애플리케이션을 프로덕션 계정으로 승격할 수 있습니다.
    31. 선택 작업 > Start-Go-Live 검토 애플리케이션을 프로덕션 계정으로 승격합니다.
    32. 통합 키를 관리할 적격 프로덕션 계정을 선택합니다.
    33. 프로덕션 컨텐츠 계정에 로그인합니다 DocuSign .
    34. 프로필 사진을 선택합니다.
    35. Go to Admin(관리자로 이동)을 선택합니다.
    36. 왼쪽 창에서 통합 > 앱 및 키레이블이 표시됩니다.
      인스턴스의 통합 프로파일에 사용할 API 계정 ID를 ServiceNow 찾습니다.
    37. 애플리케이션 옆에서 작업 > 편집레이블이 표시됩니다.
    38. URI를 추가하고 https:// ServiceNow instance.service-now.com/oauth_redirect.do 를 추가합니다.
    39. 비밀 키 추가를 선택합니다.
      프로덕션 계정의 비밀 키(클라이언트 비밀)를 인스턴스에서 ServiceNow 사용할 수 있도록 안전한 위치에 저장합니다.
    40. 저장을 선택합니다.

    DocuSign 통합 프로파일 생성

    통합 프로필을 생성하여 소프트웨어 구독을 추적하고 서비스에 대한 라이센스를 최적화합니다 DocuSign .

    시작하기 전에

    통합 프로파일을 DocuSign 생성하려면 ServiceNow Store에서 소프트웨어 자산 관리 플러그인SaaS 라이선스 관리(com.sn_sam_saas_int)을 요청하십시오.

    ServiceNow 필요한 역할: sam_integrator 또는 admin

    이 태스크 정보

    소프트웨어 자산 작업 공간을 사용하는 경우 코어 UI에서 통합 프로파일을 DocuSign 생성하는 옵션이 비활성화됩니다.

    프로시저

    1. 통합 프로파일로 이동합니다.
      인터페이스작업
      코어 UI
      1. 다음으로 이동 모두 > 소프트웨어 자산 > SaaS 라이선스 > 직접 통합 프로 파일레이블이 표시됩니다.
      2. 새로 만들기를 선택합니다.
      3. DocuSign 통합 프로파일을 선택합니다.
      소프트웨어 자산 워크플레이스
      1. 다음으로 이동 라이센스 운영 > 사용자 구독 > 직접 통합 프로파일레이블이 표시됩니다.
      2. 새로 만들기를 선택합니다.
      3. 드롭다운 목록에서 DocuSign 을 선택합니다.
      4. 계속을 선택합니다.
    2. 양식의 필드에 내용을 입력합니다.
      표 1. 통합 프로파일 양식
      필드 값
      표시 이름 통합 프로파일의 이름입니다. 예: DocuSign 통합
      클라이언트 ID 관리자 계정의 10단계에서 생성된 OAuth 애플리케이션의 클라이언트 ID입니다 SaaS .
      리디렉션 URL 인증 후 리디렉션되는 OAuth 제공자의 URL입니다. 이 값은 자동으로 채워집니다.
      기술 계정 ID 프로덕션 계정의 API 계정 ID입니다 DocuSign .
      인스턴스 URL 프로덕션 계정에 액세스하는 데 사용되는 로그인 페이지의 URL입니다 DocuSign . 이 필드는 https://account.docusign.com 로 자동 설정됩니다.
      클라이언트 비밀 39단계에서 만든 클라이언트 ID와 연결된 암호입니다.
      프로파일 유형 통합 프로파일의 유형입니다. 이 값은 DocuSign 구독으로 자동 설정됩니다.
    3. 제출을 클릭합니다.
    4. 통합 프로파일에서 OAuth 토큰 가져오기 를 선택하고 단계에 따라 OAuth 토큰을 가져옵니다.

    결과

    현재 날짜로부터 최대 1년 전까지 개별 사용자가 수행한 이벤트를 볼 수 있습니다. 자세한 내용은 소프트웨어 재생 규칙 검토 문서를 참조하십시오.
    주:
    소프트웨어 자산 관리 프로파일 생성 날짜와 관계없이 사용자 구독 다운로드를 시작하는 시점부터 이벤트를 가져옵니다.

    다음에 수행할 작업

    통합이 연결되면 인스턴스는 ServiceNow 매일 새로 고쳐지는 소프트웨어 모델, 재생 규칙 및 사용자 구독을 자동으로 생성합니다.

    자동으로 작성된 모든 재생 규칙을 검토하여 사용자 구독을 회수합니다. 자세한 내용은 소프트웨어 재생 규칙 검토 문서를 참조하십시오.

    자동으로 생성된 소프트웨어 모델에 대한 소프트웨어 권리를 생성하여 소유한 소프트웨어를 기준으로 사용된 소프트웨어를 추적합니다.
    또한 조정은 구독에서 예약된 작업 또는 요청 시 실행됩니다. 라이센스 워크벤치(소프트웨어 자산 관리클래식 애플리케이션) 또는 라이센스 사용량 뷰(소프트웨어 자산 작업 공간)에서 조정 결과를 볼 수 있습니다. 이러한 결과를 사용하여 라이센스 준수 위치를 확인하고 미준수를 정정할 수 있습니다.