다음을 통해 공유

자습서: Kronos Workforce Dimensions와 Microsoft Entra SSO 통합

  • 아티클

이 자습서에서는 Microsoft Entra ID와 Kronos Workforce Dimensions를 통합하는 방법에 대해 알아봅니다. Microsoft Entra ID와 Kronos Workforce Dimensions를 통합하면 다음을 수행할 수 있습니다.

  • Kronos Workforce Dimensions에 대한 액세스 권한이 있는 사용자를 Microsoft Entra ID에서 제어합니다.
  • 사용자가 자신의 Microsoft Entra 계정으로 Kronos Workforce Dimensions에 자동으로 로그인되도록 설정합니다.
  • 하나의 중앙 위치에서 계정을 관리합니다.

필수 조건

시작하려면 다음 항목이 필요합니다.

  • Microsoft Entra 구독. 구독이 없는 경우 무료 계정을 얻을 수 있습니다.
  • Kronos Workforce Dimensions SSO(Single Sign-On)가 설정된 구독.

참고 항목

이 통합은 Microsoft Entra 미국 정부 클라우드 환경에서도 사용할 수 있습니다. 이 애플리케이션은 Microsoft Entra 미국 정부 클라우드 애플리케이션 갤러리에서 찾을 수 있으며 퍼블릭 클라우드에서 하는 것과 동일한 방법으로 구성할 수 있습니다.

시나리오 설명

이 자습서에서는 테스트 환경에서 Microsoft Entra SSO를 구성하고 테스트합니다.

  • Kronos Workforce Dimensions는 SP 시작 SSO를 지원합니다.

Kronos Workforce Dimensions의 Microsoft Entra ID 통합을 구성하려면 갤러리의 Kronos Workforce Dimensions를 관리형 SaaS 앱 목록에 추가해야 합니다.

  1. 최소한 클라우드 애플리케이션 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
  2. ID>애플리케이션>엔터프라이즈 애플리케이션>새 애플리케이션으로 이동합니다.
  3. 갤러리에서 추가 섹션의 검색 상자에 Kronos Workforce Dimensions를 입력합니다.
  4. 결과 창에서 Kronos Workforce Dimensions를 선택한 다음, 앱을 추가합니다. 앱이 테넌트에 추가될 때까지 잠시 동안 기다려 주세요.

또는 Enterprise App Configuration 마법사를 사용할 수도 있습니다. 이 마법사에서는 테넌트에 애플리케이션을 추가하고, 앱에 사용자/그룹을 추가하고, 역할을 할당하고, SSO 구성을 연습할 수 있습니다. Microsoft 365 마법사에 대한 자세한 정보

Kronos Workforce Dimensions에 대한 Microsoft Entra SSO 구성 및 테스트

B.Simon이라는 테스트 사용자를 사용하여 Kronos Workforce Dimensions에서 Microsoft Entra SSO를 구성하고 테스트합니다. SSO가 작동하려면 Microsoft Entra 사용자와 Kronos Workforce Dimensions의 관련 사용자 간에 연결 관계를 설정해야 합니다.

Kronos Workforce Dimensions에서 Microsoft Entra SSO를 구성하고 테스트하려면 다음 단계를 수행합니다.

  1. Microsoft Entra SSO 구성 - 사용자가 이 기능을 사용할 수 있도록 합니다.
    1. Microsoft Entra 테스트 사용자 만들기 - B.Simon을 사용하여 Microsoft Entra Single Sign-On을 테스트합니다.
    2. Microsoft Entra 테스트 사용자 할당 - B.Simon이 Microsoft Entra Single Sign-On을 사용할 수 있도록 합니다.
  2. Kronos Workforce Dimensions SSO 구성 - 애플리케이션 쪽에서 Single Sign-On(SSO) 설정을 구성합니다.
    1. Kronos Workforce Dimensions 테스트 사용자 만들기 - Microsoft Entra 표현과 연결된 B.Simon에 해당하는 사용자를 Kronos Workforce Dimensions에 만듭니다.
  3. SSO 테스트 - 구성이 작동하는지 여부를 확인합니다.

Microsoft Entra SSO 구성

다음 단계에 따라 Microsoft Entra SSO를 사용하도록 설정합니다.

  1. 최소한 클라우드 애플리케이션 관리자로 Microsoft Entra 관리 센터에 로그인합니다.

  2. ID>애플리케이션>엔터프라이즈 애플리케이션>Kronos Workforce Dimensions>Single Sign-On으로 이동합니다.

  3. Single Sign-On 방법 선택 페이지에서 SAML을 선택합니다.

  4. SAML로 Single Sign-On 설정 페이지에서 기본 SAML 구성에 대한 연필 아이콘을 클릭하여 설정을 편집합니다.

    기본 SAML 구성을 편집하는 방법을 보여 주는 스크린샷.

  5. 기본 SAML 구성 섹션에서 다음 단계를 수행합니다.

    a. 식별자(엔터티 ID) 텍스트 상자에서 https://<SUBDOMAIN>.<ENVIRONMENT>.mykronos.com/authn/<TENANT_ID/hsp/<TENANT_NUMBER> 패턴을 사용하는 URL을 입력합니다.

    b. 로그온 URL 텍스트 상자에서 다음 패턴 중 하나를 사용하여 URL을 입력합니다.

    로그온 URL
    https://<CUSTOMER>-<ENVIRONMENT>-sso.<ENVIRONMENT>.mykronos.com/
    https://<CUSTOMER>-sso.<ENVIRONMENT>.mykronos.com/

    참고 항목

    이러한 값은 실제 값이 아닙니다. 해당 값을 실제 식별자 및 로그온 URL로 업데이트합니다. 이러한 값을 얻으려면 Kronos Workforce Dimensions 클라이언트 지원 팀에 문의하세요. 기본 SAML 구성 섹션에 표시된 패턴을 참조할 수도 있습니다.

  6. SAML로 Single Sign-On 설정 페이지의 SAML 서명 인증서 섹션에서 복사 단추를 클릭하여 앱 페더레이션 메타데이터 URL을 복사한 후 컴퓨터에 저장합니다.

    인증서 다운로드 링크를 보여 주는 스크린샷.

Microsoft Entra 테스트 사용자 만들기

이 섹션에서는 B.Simon이라는 사용자를 만듭니다.

  1. 최소한 사용자 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
  2. ID>사용자>모든 사용자로 이동합니다.
  3. 화면 위쪽에서 새 사용자>새 사용자 만들기를 선택합니다.
  4. 사용자 속성에서 다음 단계를 수행합니다.
    1. 표시 이름 필드에서 B.Simon을 입력합니다.
    2. 사용자 계정 이름 필드에서 username@companydomain.extension을 입력합니다. 예: B.Simon@contoso.com.
    3. 암호 표시 확인란을 선택한 다음, 암호 상자에 표시된 값을 적어둡니다.
    4. 검토 + 만들기를 선택합니다.
  5. 만들기를 선택합니다.

Microsoft Entra 테스트 사용자 할당

이 섹션에서는 Single Sign-On을 사용할 수 있도록 B.Simon에게 Kronos Workforce Dimensions에 대한 액세스 권한을 부여합니다.

  1. 최소한 클라우드 애플리케이션 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
  2. ID>애플리케이션>엔터프라이즈 애플리케이션>Kronos Workforce Dimensions으로 이동합니다.
  3. 앱의 개요 페이지에서 사용자 및 그룹을 선택합니다.
  4. 사용자/그룹 추가를 선택한 다음, 할당 추가 대화 상자에서 사용자 및 그룹을 선택합니다.
    1. 사용자 및 그룹 대화 상자의 사용자 목록에서 B.Simon을 선택한 다음, 화면 아래쪽에서 선택 단추를 클릭합니다.
    2. 사용자에게 역할을 할당할 것으로 예상되는 경우 역할 선택 드롭다운에서 선택할 수 있습니다. 이 앱에 대한 역할이 설정되지 않은 경우 "기본 액세스" 역할이 선택된 것으로 표시됩니다.
    3. 할당 추가 대화 상자에서 할당 단추를 클릭합니다.

Kronos Workforce Dimensions SSO 구성

Kronos Workforce Dimensions 쪽에서 Single Sign-On을 구성하려면 앱 페더레이션 메타데이터 URL을 Kronos Workforce Dimensions 지원 팀으로 보내야 합니다. 이렇게 설정하면 SAML SSO 연결이 양쪽에서 제대로 설정됩니다.

Kronos Workforce Dimensions 테스트 사용자 만들기

이 섹션에서는 Kronos Workforce Dimensions에서 Britta Simon이라는 사용자를 만듭니다. Kronos Workforce Dimensions 지원 팀과 협력하여 Kronos Workforce Dimensions 플랫폼에 사용자를 추가합니다. Single Sign-On을 사용하려면 먼저 사용자를 만들고 활성화해야 합니다.

참고 항목

원래 Microsoft 설명서에서는 이메일을 통해 UKG 지원팀에 문의하여 Microsoft Entra 사용자를 만들 것을 권합니다. 이 옵션을 사용할 수 있지만 다음 셀프 서비스 옵션을 고려하세요.

수동 프로세스

WFD에서 Microsoft Entra 사용자를 수동으로 만드는 방법에는 두 가지가 있습니다. 기존 사용자를 선택하고 복제한 다음 필요한 필드를 업데이트하여 해당 사용자를 고유하게 만들 수 있습니다. 이 프로세스는 시간이 많이 걸릴 수 있으며 WFD 사용자 인터페이스에 대한 지식이 필요합니다. 그 대안은 훨씬 더 빠른 WFD API를 통해 사용자를 만드는 것입니다. 이 옵션을 사용하려면 Postman 같은 API 도구를 사용하여 요청을 API로 보내는 방법을 알고 있어야 합니다. 다음 지침대로 하면 Postman API 도구로 미리 빌드된 예제를 쉽게 가져올 수 있습니다.

설치

  1. Postman 도구를 열고 다음 파일을 가져옵니다.

    a. Workforce 차원 - User.postman_collection.json 만들기

    b. WFD Env Variables.json에 대한 Microsoft Entra ID

  2. 왼쪽 창에서 환경 단추를 선택합니다.

  3. AAD_to_WFD_Env_Variables를 클릭하고 WFD 인스턴스와 관련하여 UKG 지원팀에서 제공한 값을 추가합니다.

    참고 항목

    액세스 토큰 가져오기 HTTP 요청에 따라 자동으로 채워지기 때문에 access_token 및 refresh_token이 비어 있어야 합니다.

  4. WFD에서 Microsoft Entra 사용자 만들기 HTTP 요청을 열고 JSON 페이로드 내에서 강조 표시된 속성을 업데이트합니다.

    { 

"personInformation": { 

   "accessAssignment": { 

      "accessProfileName": "accessProfileName", 

      "notificationProfileName": "All" 

    }, 

    "emailAddresses": [ 

      { 

        "address": "address” 

        "contactTypeName": "Work" 

      } 

    ], 

    "employmentStatusList": [ 

      { 

        "effectiveDate": "2019-08-15", 

        "employmentStatusName": "Active", 

        "expirationDate": "3000-01-01" 

      } 

    ], 

    "person": { 

      "personNumber": "personNumber", 

      "firstName": "firstName", 

      "lastName": "lastName", 

      "fullName": "fullName", 

      "hireDate": "2019-08-15", 

      "shortName": "shortName" 

    }, 

    "personAuthenticationTypes": [ 

      { 

        "activeFlag": true, 

        "authenticationTypeName": "Federated" 

      } 

    ], 

    "personLicenseTypes": [ 

      { 

        "activeFlag": true, 

        "licenseTypeName": "Employee" 

      }, 

      { 

        "activeFlag": true, 

        "licenseTypeName": "Absence" 

      }, 

      { 

        "activeFlag": true, 

        "licenseTypeName": "Hourly Timekeeping" 

      }, 

      { 

        "activeFlag": true, 

        "licenseTypeName": "Scheduling" 

      } 

    ], 

    "userAccountStatusList": [ 

      { 

        "effectiveDate": "2019-08-15", 

        "expirationDate": "3000-01-01", 

        "userAccountStatusName": "Active" 

      } 

    ] 

  }, 

  "jobAssignment": { 

    "baseWageRates": [ 

      { 

        "effectiveDate": "2019-01-01", 

        "expirationDate": "3000-01-01", 

        "hourlyRate": 20.15 

      } 

    ], 

    "jobAssignmentDetails": { 

      "payRuleName": "payRuleName", 

      "timeZoneName": "timeZoneName" 

    }, 

    "primaryLaborAccounts": [ 

      { 

        "effectiveDate": "2019-08-15", 

        "expirationDate": "3000-01-01", 

        "organizationPath": "organizationPath" 

      } 

    ] 

  }, 

  "user": { 

    "userAccount": { 

      "logonProfileName": "Default", 

      "userName": "userName" 

    } 

  } 

}

    참고 항목

    personInformation.emailAddress.address 및 user.userAccount.userName 모두 WFD에서 만들려는 대상 Microsoft Entra 사용자와 일치해야 합니다.

  5. 오른쪽 위 모서리에서 환경 드롭다운 상자를 선택하고 AAD_to_WFD_Env_Variables를 선택합니다.

  6. JSON 페이로드가 업데이트되고 올바른 환경 변수가 선택되면 액세스 토큰 가져오기 HTTP 요청을 선택하고 보내기 단추를 클릭합니다. 이렇게 하면 업데이트된 환경 변수를 활용하여 WFD 인스턴스에 인증한 다음, create user 메서드를 호출할 때 사용할 환경 변수에 액세스 토큰을 캐시합니다.

  7. 인증 호출에 성공하면 액세스 토큰이 반환된 200 응답이 표시됩니다. 이제 이 액세스 토큰은 access_token 항목에 해당하는 환경 변수의 CURRENT VALUE 열에도 표시됩니다.

    참고 항목

    access_token 수신되지 않으면 환경 변수의 모든 변수가 올바른지 확인합니다. 사용자 자격 증명은 슈퍼 사용자 계정이어야 합니다.

  8. access_token을 가져온 후 AAD_to_WFD_Env_Variables HTTP 요청을 선택하고 보내기 단추를 클릭합니다. 요청이 성공하면 200 HTTP 상태를 다시 받게 됩니다.

  9. 슈퍼 사용자 계정으로 WFD에 로그인하고 새 Microsoft Entra 사용자가 WFD 인스턴스 내에 만들어졌는지 확인합니다.

자동화된 프로세스

자동화된 프로세스는 사용자가 위의 수동 API 프로세스에서 페이로드의 강조 표시된 값을 미리 지정할 때 사용할 수 있는 CSV 형식의 플랫 파일로 구성됩니다. 플랫 파일은 새 WFD 사용자를 대량으로 만드는 PowerShell 스크립트가 사용합니다. 스크립트는 최적의 성능을 내도록 구성할 수 있는 70(기본값)의 일괄 처리로 새 사용자 만들기를 처리합니다. 다음 지침은 스크립트의 설정 및 실행 방법을 설명합니다.

  1. AAD_To_WFD.csv 파일과 AAD_To_WFD.ps1 파일을 모두 컴퓨터에 로컬로 저장합니다.

  2. AAD_To_WFD.csv 파일을 열고 열을 채웁니다.

    • personInformation.accessAssignment.accessProfileName: WFD 인스턴스의 특정 액세스 프로필 이름입니다.

    • personInformation.emailAddresses.address: Microsoft Entra ID의 사용자 원칙 이름과 일치해야 합니다.

    • personInformation.personNumber: WFD 인스턴스에서 고유해야 합니다.

    • personInformation.firstName: 사용자의 이름입니다.

    • personInformation.lastName: 사용자의 성입니다.

    • jobAssignment.jobAssignmentDetails.payRuleName: WFD의 특정 급여 규칙 이름입니다.

    • jobAssignment.jobAssignmentDetails.timeZoneName: 표준 시간대 형식은 WFD 인스턴스(즉, (GMT -08:00) Pacific Time)와 일치해야 합니다.

    • jobAssignment.primaryLaborAccounts.organizationPath: WFD 인스턴스의 특정 비즈니스 구조에 대한 조직 경로입니다.

  3. .csv 파일을 저장합니다.

  4. AAD_To_WFD.ps1 스크립트를 오른쪽 단추로 클릭한 후 편집을 클릭하여 수정합니다.

  5. 줄 15에 지정된 경로가 AAD_To_WFD.csv 파일의 올바른 이름/경로인지 확인합니다.

  6. 다음 줄을 WFD 인스턴스와 관련된 UKG 지원팀에서 제공하는 값으로 업데이트합니다.

    • 줄 33: vanityUrl

    • 줄 43: appKey

    • 줄 48: client_id

    • 줄 49: client_secret

  7. 스크립트를 저장하고 실행합니다.

  8. 메시지가 표시되면 WFD 슈퍼 사용자 자격 증명을 제공합니다.

  9. 완료되면 스크립트에서 만들지 못한 모든 사용자 목록을 반환합니다.

참고 항목

WFD 인스턴스에서 오타 또는 일치하지 않는 필드의 결과로 반환되는 경우 AAD_To_WFD.csv 파일에 제공된 값을 확인해야 합니다. 일괄 처리의 모든 사용자가 인스턴스에 이미 있는 경우 WFD API 인스턴스에서도 오류를 반환할 수 있습니다.

SSO 테스트

이 섹션에서는 다음 옵션을 사용하여 Microsoft Entra Single Sign-On 구성을 테스트합니다.

  • 이 애플리케이션 테스트를 클릭하면 로그인 흐름을 시작할 수 있는 Kronos Workforce Dimensions 로그온 URL로 리디렉션됩니다.

  • Kronos Workforce Dimensions 로그온 URL로 직접 이동하여 해당 위치에서 로그인 흐름을 시작합니다.

  • Microsoft 내 앱을 사용할 수 있습니다. 내 앱에서 Kronos Workforce Dimensions 타일을 클릭하면 Kronos Workforce Dimensions 로그온 URL로 리디렉션됩니다. 내 앱에 대한 자세한 내용은 내 앱 소개를 참조하세요.

다음 단계

Kronos Workforce Dimensions가 구성되면 세션 제어를 적용하여 조직의 중요한 데이터의 반출 및 반입을 실시간으로 보호할 수 있습니다. 세션 제어는 조건부 액세스에서 확장됩니다. Microsoft Defender for Cloud Apps를 사용하여 세션 제어를 적용하는 방법을 알아봅니다.