DocuSign와의 통합

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

    • 애플리케이션을 DocuSign 서비스와 통합 소프트웨어 자산 관리 하면 소프트웨어 구독을 추적하고 사용하지 않는 라이센스를 회수할 수 있습니다.

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

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

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

    중요사항:
    필요한 사용자 또는 API 권한에만 액세스 권한을 부여하여 보안 위험을 최소화하고 정보를 보호합니다.
    표 1. 최소 사용자 권한
    프로세스 애플리케이션에서 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. 추가 설정 섹션의 리디렉션 URI 필드에서 ADD URI를 선택합니다.
    8. https://oauth.pstmn.io/v1/browser-callback 추가합니다.
    9. URI를 다시 선택하고 https:// ServiceNow instance.service-now.com/oauth_redirect.do 를 추가합니다.
    10. ADD SECRET KEY를 선택합니다.
      통합 키(클라이언트 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. 관리자로 이동을 선택합니다.
    36. 왼쪽 창에서 통합 > 앱 및 키.
      인스턴스의 통합 프로파일에 사용할 API 계정 ID를 ServiceNow 찾습니다.
    37. 애플리케이션 옆에 있는 작업 > 편집.
    38. URI 추가를 선택하고 https:// ServiceNow instance.service-now.com/oauth_redirect.do 를 추가합니다.
    39. ADD SECRET KEY를 선택합니다.
      프로덕션 계정의 비밀 키(클라이언트 비밀)를 인스턴스에서 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. 양식의 필드에 내용을 입력합니다.
      표 2. 통합 프로파일 양식
      필드 값
      표시 이름 통합 프로파일의 이름입니다. 예: 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 자동으로 소프트웨어 모델, 재생 규칙 및 매일 새로 고쳐지는 사용자 구독을 생성합니다.

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

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