REST API를 사용하도록 Workday 구성

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 8분

    • REST API를 사용하는 작업을 수행하도록 인스턴스를 구성 ServiceNow 합니다.Workday

    시작하기 전에

    • 통합 허브 구독을 요청합니다.
    • 스포크를 활성화합니다 Workday HR .
    • Workday에서 이러한 값을 가져와 나중에 사용할 수 있도록 기록합니다. 다음 값은 클라이언트를 등록하는 데 필요합니다.
      • 클라이언트 ID
      • 클라이언트 비밀
      • Workday REST API 엔드포인트
      • 토큰 엔드포인트
      • 권한 부여 엔드포인트
    • 필요한 역할: 관리자

    이 태스크 정보

    Workday REST 및 RAAS(Report-as-a-Service) API는 OAuth 2.0과 함께 작동하여 테넌트의 리소스에 대한 액세스 권한을 부여합니다 Workday . OAuth 2.0을 사용하려면 API 클라이언트 등록 작업을 사용하여 테넌트에 클라이언트를 등록해야 합니다.

    다음과 같은 REST 기반 스포크 작업을 사용해야 하는 경우 REST API를 Workday 사용하도록 인스턴스를 구성 ServiceNow 합니다.
    • 내 보고 구조 가져오기
    • 객체 사용자 지정 필드 조회
    • 객체 사용자 지정 필드 업데이트
    • 급여명세서 조회
    • 보고서를 사용하여 총 보상 조회
    • 사용자 지정 보고서 조회
    • 인박스 항목 조회
    • 직원의 성과와 혜택 계획 상세 정보 조회
    • 직원의 공휴일 달력 참조 WID 조회
    • 직원의 일정 달력 참조 WID 조회
    • 직원의 공휴일 달력 조회
    • WQL 스트림을 사용하여 조회
    주:
    이러한 구성은 REST 기반 스포크 작업을 사용하는 데 필요합니다.

    OAuth 제공자로 등록 Workday HR

    인스턴스가 OAuth 2.0 토큰을 요청할 수 있도록 ServiceNow 인스턴스를 Workday HR OAuth 제공자로 등록합니다.

    시작하기 전에

    필요한 역할: 관리자

    프로시저

    1. 다음으로 이동 모두 > 시스템 OAuth > 애플리케이션 레지스트리.
    2. 새로 만들기를 클릭합니다.
      시스템에 다음 메시지가 표시됩니다. 어떤 종류의 OAuth 애플리케이션입니까?.
    3. 외부 공급업체 OAuth 제공자에 연결을 선택합니다.
    4. 양식에서 다음 값을 입력합니다.
      표 1. 애플리케이션 레지스트리 양식
      필드 설명
      이름 기록을 고유하게 식별하는 이름입니다. 예를 들어 다음과 같이 입력합니다. Workday HR OAuth
      애플리케이션 기록을 적용할 수 있는 애플리케이션입니다. Workday HR 스포크를 선택합니다.
      클라이언트 ID 클라이언트를 등록하는 동안 생성된 클라이언트 ID입니다.
      클라이언트 비밀 클라이언트를 등록하는 동안 생성된 클라이언트 비밀입니다.
      인증 URL 클라이언트를 등록하는 동안 생성되는 인증 엔드포인트입니다.
      토큰 URL 클라이언트를 등록하는 동안 생성된 토큰 엔드포인트입니다.
      리디렉션 URL 다음 형식의 OAuth 콜백 엔드포인트: https://<인스턴스>.service-now.com/oauth_redirect.do
      기본 부여 유형 토큰을 설정하는 데 사용된 부여 유형입니다. 인증 코드를 선택합니다.
      활성 애플리케이션 레지스트리를 적극적으로 사용하는 옵션입니다.
    5. 양식 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다.
      OAuth 엔터티 프로파일이 생성됩니다.

    Workday HR 스포크에 대한 토큰 URL 생성

    Workday 계정에 API 클라이언트를 등록하고 Workday HR 스포크에 대한 토큰 URL을 생성합니다.

    시작하기 전에

    필요한 역할: 관리자

    프로시저

    1. Workday 테넌트에 로그인합니다.
    2. 검색으로 이동하여 API 클라이언트 등록 작업을 입력합니다.
    3. API 클라이언트 등록에서 상세 정보를 입력합니다.
      필드 설명
      클라이언트 이름 앱의 클라이언트 이름입니다. 예를 들어 Workday HR 스포크입니다.
      클라이언트 부여 유형 승인 코드 부여를 선택합니다.
      접근 토큰 유형 접근 토큰 유형: 전달자 선택
      리디렉션 URI ServiceNow URL을 https://<instance>.service-now.com/oauth_redirect.do 형식으로 입력합니다.
      만료되지 않는 새로 고침 토큰 만료되지 않는 새로 고침 토큰을 활성화하는 옵션입니다.
      범위(기능 영역) 필요한 기능 영역을 선택합니다.
      Workday 소유 범위 포함 Workday가 소유한 범위를 선택하는 옵션입니다.
    4. 확인을 클릭합니다.

    결과

    시스템 속성을 구성하기 위해 생성된 토큰 엔드포인트 값을 복사하고 저장합니다.

    옵션 1: 템플릿과 함께 HR REST API를 사용하도록 Workday 구성

    OAuth 인증 템플릿을 사용하여 REST API를 사용하는 Workday HR 작업을 수행하도록 인스턴스를 구성 ServiceNow 합니다.

    시작하기 전에

    필요한 역할: 관리자

    Workday HR REST API에 대한 연결 구성

    Workday HR 스포크에서 ServiceNow 요청을 인증하기 위해 Workday HR REST API 연결을 추가하고 구성합니다.

    시작하기 전에

    프로시저

    1. 다음으로 이동 모두 > 프로세스 자동화 > 워크플로우 스튜디오.
    2. 통합을 선택합니다.
    3. 연결 탭을 선택합니다.
    4. 검색 상자를 사용하여 WorkdayHR 연결 별칭을 찾습니다.
    5. 세부 정보 보기를 클릭합니다.
      Workday HR 스포크에 대한 연결 템플릿
    6. 클라우드 연결을 구성합니다.
      1. 클라우드 연결을 추가하거나 편집합니다.
        • 기존 연결을 설정하려면 구성 또는 편집을 선택합니다.Workday HR 스포크에 대한 연결 템플릿을 사용하여 연결 구성
        • 새 연결을 만들고 구성하려면 연결 추가를 선택합니다.
      2. 구성 양식의 필드에 내용을 입력합니다.
      표 2. 구성 양식
      필드 설명
      이름 연결을 고유하게 식별하는 이름입니다. 예를 들어 Workday HR 스포크 연결입니다.
      연결 URL Workday HR에 연결하기 위한 URL입니다. https://<workday_host>/ccx/service/<tenant_name> 형식을 사용합니다.
      테넌트 이름 Workday 테넌트의 이름입니다. 예를 들면 bcone_gms1입니다.
      API 버전 요청에 사용할 Workday API의 버전입니다.
      클라이언트 ID OAuth 인증을 위해 Workday에서 생성된 클라이언트 ID입니다.
      클라이언트 비밀 OAuth 인증을 위해 Workday에서 생성된 클라이언트 비밀입니다.
      인증 URL OAuth 연결 권한을 부여하는 데 사용되는 URL입니다. https://<workday_host>/authorize 형식을 사용합니다.
      토큰 URL OAuth 토큰을 생성하는 데 사용되는 URL입니다. https://<workday_host>/token 형식을 사용합니다.
      OAuth 리디렉션 URL 인증에 성공한 후 Workday가 리디렉션되는 URL입니다. https://<instance_name>.service-now.com/oauth_redirect.do 형식을 사용합니다.
    7. 저장 및 OAuth 토큰 가져오기를 클릭합니다.

    결과

    스포크 연결이 구성되어 사용할 준비가 되었습니다.

    옵션 2: 템플릿 없이 HR REST API를 사용하도록 Workday 구성

    연결 및 자격 증명 기록을 수동으로 생성하여 REST API를 Workday HR 사용하는 작업을 수행하도록 인스턴스를 구성 ServiceNow 합니다.

    시작하기 전에

    필요한 역할: 관리자

    스포크에 Workday HR 대한 자격 증명 기록 생성

    인스턴스에 대한 자격 증명 기록을 Workday HR 생성합니다. 스포크 연결 및 자격 증명 별칭은 Workday HR 이러한 자격 증명을 사용하여 작업을 승인합니다.

    시작하기 전에

    필요한 역할: admin.

    프로시저

    1. 다음으로 이동 모두 > 연결 및 자격 증명 > 자격 증명.
    2. 새로 만들기를 클릭합니다.

      시스템에 다음 메시지가 표시됩니다. 어떤 유형의 자격 증명을 작성하시겠습니까?

    3. OAuth 2.0 자격 증명을 선택합니다.
    4. 양식에서 다음 값을 입력합니다.
      표 3. OAuth 2.0 자격 증명 양식
      필드 설명
      이름 기록을 고유하게 식별하는 이름입니다. 예를 들어 Workday HR Cred입니다.
      활성 자격 증명 기록을 적극적으로 사용하는 옵션입니다.
      OAuth 엔터티 프로파일 OAuth 제공자로 등록 Workday HR 하는 동안 생성된 OAuth 엔터티 프로파일입니다. 예를 들어 OAuth 프로파일입니다 .
    5. 양식 헤더를 마우스 오른쪽 버튼으로 클릭하고 제출을 클릭합니다.
    6. OAuth 토큰을 생성하려면 OAuth 토큰 가져오기 관련 링크를 클릭합니다.

    Workday HR 스포크에 대한 연결 기록 생성

    인스턴스에 대한 연결 기록을 Workday HR 생성합니다. Workday HR 스포크 연결 및 자격 증명 별칭은 이러한 연결을 사용하여 에서 Workday HR작업을 수행합니다.

    시작하기 전에

    필요한 역할: admin.

    프로시저

    1. 다음으로 이동 모두 > 연결 및 자격 증명 > 연결 및 자격 증명 별칭.
    2. 별칭 기록인 WorkdayHR을 엽니다.
    3. 연결 탭에서 신규를 클릭합니다.
    4. 양식에서 다음 필드를 채웁니다.
      주:
      Workday HR 스포크 애플리케이션에서 연결 기록을 생성해야 합니다.
      표 4. 연결 양식
      필드 설명
      이름 기록을 고유하게 식별하는 이름입니다. 예: Workday HR 연결.
      자격 증명 Workday HR 스포크에 대해 생성된 자격 증명 기록입니다. 예를 들어 Workday HR Cred입니다.
      연결 별칭 이 연결과 관련된 별칭 기록입니다.
      연결 URL 인스턴스에 연결하기 위한 URL입니다 Workday HR .
      활성 연결 기록을 적극적으로 사용하는 옵션입니다.
    5. 속성 탭에서 다음 값을 입력합니다.
      필드 값
      테넌트 이름 애플리케이션의 테넌트 이름입니다 Workday .
      버전 v1
    6. 제출을 클릭합니다.