Okta를 통해 HubSpot 사용자에게 SCIM 제공

SCIM(System for Cross-domain Identity Management)을 통해 사용자를 프로비저닝하면 Okta를 통해 HubSpot 사용자를 안전하고 자동화된 방식으로 생성 및 관리할 수 있습니다.

신원 제공자가 Okta나 Google이 아닌 경우, 사용자 정의 SCIM 통합을 설정할 수 있습니다. 이를 통해 Microsoft Entra ID, PingFederate, OneLogin, JumpCloud와 같은 제공자로부터 사용자를 프로비저닝하도록 SCIM을 설정할 수 있습니다. 신원 제공자에 대한 SCIM 설정에 대해 자세히 알아보세요.

아래에서 Okta를 통한 사용자 프로비저닝 설정 방법을 확인해 보세요.

시작하기 전에

이 기능을 사용하기 전에, 사전에 수행해야 할 단계와 기능의 제한 사항, 그리고 사용 시 발생할 수 있는 결과를 완전히 이해해야 합니다.

필수 조건 파악

• HubSpot 계정에서싱글 사인온(SSO)이 활성화되어 있어야 합니다.
• SCIM을 설정하기 전에 팀의 Okta 역할에 따라 HubSpot에서 사용자 권한 세트를 설정하는 것이 좋습니다.
• 사용자 권한을 설정하려면 HubSpot에서 권한 세트를 생성해야 합니다. 그러면 Okta에서 사용자의 역할이 HubSpot 권한 세트의 이름과 일치하는 경우 해당 사용자에게 권한을 할당할 수 있습니다.
• 도메인을 확인하려면 DNS 레코드를 업데이트해야 합니다. DNS 공급자의 로그인 정보가 있고 TXT 레코드에 액세스할 수 있는지 확인하십시오.

제한 사항 및 고려 사항 이해

• 좌석 할당은 좌석 기반 요금제를 사용 중인지 여부에 따라 달라집니다.
  • 좌석 기반 요금제를 사용하지 않는 경우: SCIM으로 설정된 사용자에게 좌석을 할당하려면 HubSpot에서 좌석을 구매하고 유료 좌석이 포함된 권한 세트를 생성하십시오. Okta로 돌아가 사용자의 역할을 해당 권한 세트와 동일하게 설정하십시오.
  • 좌석 기반 요금제를 사용하는 경우: SCIM/API를 통해 권한 세트가 할당되면, HubSpot은 해당 세트의 모든 권한을 지원하는 사용 가능한 최적의 좌석에 사용자를 자동으로 할당합니다.

SCIM 프로비저닝 설정

Okta를 통해 SCIM 사용자 프로비저닝을 설정하려면, 먼저 Okta에 HubSpot 앱을 추가한 다음 해당 앱에 사용자를 할당해야 합니다.

1. Okta에 로그인합니다.
2. 왼쪽 사이드바 메뉴에서 [ 애플리케이션] > [ 애플리케이션]을 선택한 다음, Okta 계정에서 HubSpot 애플리케이션을 찾아 추가합니다.
3. HubSpot 애플리케이션 화면에서 ‘프로비저닝 ’ 탭을 클릭한 다음, ‘API 통합 구성’을 클릭합니다.
   
   
   
4. 'API 통합 활성화' 확인란을 선택한 다음 'HubSpot으로 인증'을 클릭합니다. 새 창이 열리면 Okta가 HubSpot 계정에 액세스할 수 있도록 허용할 수 있습니다.
5. HubSpot 창에서 Okta와 연동할 계정을 선택한 다음, '계정 선택'을 클릭합니다.
6. '앱 연결'을 클릭합니다. 창이 닫히고 Okta 관리 콘솔로 이동합니다.
7. '저장'을 클릭합니다.
8. '프로비저닝' 탭에서 '편집'을 클릭하여 Okta가 HubSpot에 사용자를 프로비저닝하는 방식을 선택합니다.
   
   
9. '사용자 생성', '사용자 속성 업데이트' 및 '사용자 비활성화' 옆에 있는 '사용' 확인란을 선택하여 연동을 구성합니다.
10. '저장'을 클릭합니다.
11. 그런 다음 HubSpot 앱에 사용자를 할당하세요.

도메인 확인

Okta를 통해 HubSpot 앱을 추가한 후, DNS 레코드를 업데이트하여 HubSpot에서 도메인을 확인해야 합니다.

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서 ‘통합’ > ‘연결된 앱’으로 이동합니다.
3. 'Okta SCIM'을 클릭합니다.
4. '일반 설정 ' 탭으로 이동합니다.
5. '도메인' 필드에 사용자의 이메일 발신 도메인을 입력합니다.
6. '저장'을 클릭합니다.
7. '지금 확인'을 클릭합니다.
   
   
   
8. 대화 상자에서 ‘다음’을 선택합니다.
9. '값' 열에 있는 값을 복사합니다. 이 값은 DNS 공급자에서 새 TXT 레코드를 생성할 때 사용하게 됩니다.
10. DNS 제공업체 계정에 로그인한 다음, 확인하려는 도메인에 대한 새 TXT 레코드를 생성하십시오. HubSpot에서 복사한 값을 '값/지정 대상/대상' 필드에 붙여넣으십시오.
11. TXT 레코드를 생성한 후 HubSpot으로 돌아가 ‘다음’을 클릭하세요. DNS 변경 사항이 반영되면 도메인이 확인됩니다.

참고: DNS 변경 사항이 전파되어 HubSpot에 반영되기까지 최대 48시간이 소요될 수 있습니다.

Okta 역할과 HubSpot 권한 세트 동기화

사용자 권한을 설정하려면 HubSpot에서 권한 세트를 생성해야 합니다. 그러면 Okta에서 사용자의 역할(Role) 이름이 공백 및 대소문자를 포함하여 HubSpot 권한 세트의 이름과 정확히 일치할 경우, 해당 사용자에게 권한을 할당할 수 있습니다.

Okta가 사용자에게 권한 세트를 할당할 수 있도록 하려면:

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서 ‘통합’ > ‘연동된 앱’을 클릭합니다.
3. '모든 앱'에서 'Okta SCIM'을 클릭합니다.
4. '권한 세트 관리'를 켜십시오.

SCIM 프로비저닝 비활성화

HubSpot에서 SCIM 프로비저닝을 비활성화하려면, Okta 계정에서 변경 사항을 적용하기 전에 HubSpot에서 Okta SCIM을 제거해야 합니다.

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서 '연동' > '연동된 앱'으로 이동합니다.
3. Okta SCIM 앱에서 '작업 ' 드롭다운 메뉴를 클릭한 다음 '제거'를 클릭합니다.
4. Okta 계정에서 사용자를 편집할 수 있게 되며, 더 이상 SCIM과 동기화되지 않습니다.

자주 묻는 질문

SCIM을 통해 생성된 사용자를 HubSpot에서 편집할 수 있나요?

HubSpot에서는 사용자 권한만 편집할 수 있으며, 권한 세트 관리가 구성되지 않은 경우에만 가능합니다. 사용자 이름 및 이메일 주소를 포함한 기타 모든 사용자 정보는 ID 제공자를 통해서만 업데이트할 수 있습니다.

할당된 Okta 역할이 HubSpot의 사용자 권한 세트에 표시되지 않는 이유는 무엇입니까?

Okta 역할을 HubSpot 권한 세트와 동기화하려면 HubSpot에서 ‘권한 세트 관리’를 활성화해야 합니다. HubSpot의 권한 세트 이름은 공백과 대소문자를 포함하여 Okta의 역할 이름과 정확히 일치해야 합니다.

Okta에서 사용자를 팀에 배정할 수 있나요?

아니요. 하지만 사용자가 HubSpot에 추가된 후에는 HubSpot에서 해당 사용자의 팀을 수동으로 업데이트할 수 있습니다.

HubSpot이나 Okta에서 SCIM 사용자를 삭제하면 어떻게 되나요?

HubSpot에서 사용자를 삭제해도 Okta의 해당 사용자는 삭제되지 않습니다. 하지만 Okta에서 사용자의 HubSpot 접근 권한을 제거하거나 Okta 계정을 비활성화하면, HubSpot에서도 해당 사용자가 비활성화됩니다. HubSpot에 사용자를 추가해도 Okta에는 해당 사용자가 추가되지 않습니다.

Okta를 연동하면 HubSpot 계정의 기존 사용자는 어떻게 되나요?

Okta를 통해 SCIM을 설정한 후, Okta의 사용자와 일치하는 기존 HubSpot 사용자는 자동으로 SCIM 사용자로 전환됩니다. HubSpot은 Okta 내 역할에 따라 사용자에게 권한 세트를 할당하려고 시도합니다. 사용자의 Okta 역할이 HubSpot에 설정된 권한과 일치하지 않는 경우, 해당 사용자는 HubSpot에서 최소한의 권한만 갖게 됩니다.

"이 도메인을 확인할 수 없습니다"라는 오류가 표시되는데, 어떻게 해결하나요?

이 오류가 표시된다면, 도메인 주소가 철자 오류 없이 올바르게 입력되었는지 확인하십시오. 또한 HubSpot의 ‘구성’ 단계에서 TXT 레코드의 올바른 값을 복사하여 DNS 제공업체에 입력했는지 확인하십시오.