Bluebeam 계정용 SSO 구성 | OIDC

적용 대상:

  • Revu 21

싱글 사인온(SSO)은 사용자가 IdP 로그인 자격 증명을 통해 Bluebeam 제품에 원활하게 액세스할 수 있도록 지원합니다.

Entra ID 또는 Okta Workforce Identity 클라우드 이외의 IdP를 사용하는 경우, 지원되지 않지만 호환되는 IdP의 SSO 구성에 대한 자세한 내용은 Bluebeam 계정용 SSO 구성 | 일반 OIDC을 참조하십시오.

Bluebeam은 공식적으로 다음 IdP에 대한 SSO 구성을 지원합니다.

Revu는 OpenID Connect(OIDC)를 인증 프로토콜로 사용하는 다른 IdP와도 호환되지만, 해당 구성은 지원되지 않으며 SCIM을 활성화할 수 없습니다. 이 문서는 호환되지만 지원되지 않는 IdP에 대해, 일반 OIDC 커넥터로 SSO를 구성하는 간단한 지침을 제공합니다. 단, 지원되지 않는 IdP에서 SSO 구성에 문제가 발생하더라도 Bluebeam 지원팀에서 문제 해결을 지원할 수 없으며, 필요에 따라 SSO를 비활성화해야 할 수도 있습니다.

Bluebeam은 인증 관리를 위한 보안 보장 마크업 언어(SAML)를 지원하지 않습니다.
SSO만 구성하고 SCIM은 구성하지 않도록 선택할 수 있습니다. 하지만 SCIM을 구성하려면 먼저 SSO를 구성해야 합니다.

요구 사항

SSO를 구성하는 기능은 다음과 같은 조직에서만 사용할 수 있습니다.

  • 최소 10개의 라이선스를 Bluebeam 구독 플랜으로 구매하거나 전환해야 합니다.
  • Bluebeam 제품 및 서비스에서 SSO를 사용하도록 아직 구성되지 않았습니다. 귀하의 조직에 이미 SSO가 구성되어 있는 경우 계속 진행하기 전에 저희에게 문의하세요 .

이러한 요구 사항을 충족하며 조직의 SSO를 활성화하려면 Org Admin이 다음 단계에 따라 SSO 구성 액세스 권한을 요청하도록 하시기 바랍니다.

  1. 웹 브라우저에 Org Admin URL을 입력하세요. Closed귀하의 지역과 일치합니다:

  2. 계정 에서 관리하려는 계정을 선택하세요.

  3. 설정을 선택하세요.

  4. SSO 구성 옆에서 액세스 요청을 선택합니다.

    귀하의 조직이 SSO 구성에 대한 요구 사항을 충족하지 못하는 경우, 액세스 요청 버튼을 사용할 수 없으며 진행할 수 없습니다.

  5. 요청된 정보를 제공하세요.

요청을 접수하고 처리한 후 SSO 구성을 진행할 수 있습니다.

도메인 청구 및 확인

SSO를 구성하려면, 우선 귀하의 조직이 소유하고 있으며 Bluebeam 계정과 연결하고자 하는 도메인을 요청한 후 확인해야 합니다. Bluebeam 계정에 여러 개의 도메인을 연결하려면, 각 도메인마다 이 절차를 개별적으로 수행해야 합니다. 하나 이상의 도메인을 요청하고 확인하지 않으면 SSO를 구성할 수 없습니다.

이 절차를 수행하려면 Org Admin 에서 정보를 복사하여 DNS 서버의 새 TXT 레코드에 붙여넣어야 합니다. 해당 단계를 준비하려면 등록하려는 각 도메인의 DNS 서버에 로그인할 준비를 해야 합니다.

  • 최대 500개의 도메인을 신청할 수 있습니다. 도메인 소유권 페이지에 이미 500개의 도메인을 신청하고 인증한 것으로 표시되는 경우, 이 절차를 완료하고 다른 도메인을 신청 및 인증하려면 먼저 목록에서 도메인 하나를 제거해야 합니다.
  • 나열된 도메인을 SSO 구성의 일부로 사용한 후에는 목록에서 해당 도메인을 제거할 수 없습니다.

도메인을 신청하고 확인하려면 다음 단계를 따르세요.

  1. In Org Admin, 선택 계정을 선택한 다음 관리하려는 계정을 선택합니다.
  2. 설정을 선택하세요.
  3. 도메인 소유권 옆에서 선택합니다.
  4. 도메인 신청을 선택하세요.
  5. 클레임하려는 도메인 이름을 입력하세요(예: 회사닷컴), 그리고 청구를 선택하세요.
  6. 도메인 확인 대화 상자에서 각 필드 옆의 복사를 선택하고, DNS 서버의 새 TXT 레코드에 해당 정보를 붙여넣습니다.
  7. 최소 5분 정도 기다린 후, 확인 확인을 선택하세요.

클레임하고 검증하려는 각 도메인에 대해 이 절차를 수행하세요.

도메인 상태가 "보류 중"인 동안에는 SSO 구성을 시작할 수 없지만, 추가 도메인을 청구하기 위해 도메인이 검증될 때까지 기다릴 필요는 없습니다.

확인 후에도 도메인 상태가 "보류 중"으로 유지되는 경우, 주기적으로 Org Admin 에 로그인하여 상태가 "확인됨:"으로 변경되었는지 확인하기 위해 다음 단계를 수행하십시오.

  1. In Org Admin, 선택 계정을 선택한 다음 관리하려는 계정을 선택합니다.
  2. 설정을 선택하세요.
  3. 도메인 소유권 옆에서 선택합니다.
  4. 도메인 소유권 페이지에서 작업 아래에 있는 세 개의 점을 선택한 다음 확인 확인을 선택합니다.

72시간이 지나도 도메인 상태가 여전히 "보류 중"인 경우, 먼저 TXT 레코드에 정보를 올바르게 입력했는지 확인하세요. TXT 레코드가 정확하다면 저희에게 연락하세요.

SSO 구성

SSO를 구성하려면 Org Admin 에서 구성을 완료하기 전에 일련의 절차 를 IdP 내에서 수행해야 합니다.

  1. IdP에서 SSO용 애플리케이션을 생성합니다.

  2. 사용자 목록을 내보내고 사용자 조정을 준비합니다.

  3. 조직 관리자에서 SSO 구성

  4. 조직 내 IdP의 사용자 ID와 Bluebeam ID 대조

SSO용 웹 애플리케이션 생성 및 SSO 구성을 위한 정보 수집

Bluebeam 계정에 SSO를 구성하려면 IdP에서 SSO용 애플리케이션을 생성해야 합니다. 이 섹션에서는 애플리케이션을 생성하는 데 필요한 일반적인 워크플로우와 정보를 설명합니다. IdP에서 SSO 애플리케이션을 생성하는 방법에 대한 자세한 내용은 해당 IdP 문서를 참조하세요.

일반적으로 준비할 사항은 다음과 같습니다.

  • 구성 옵션이 표시되면 OIDC 옵션을 선택합니다.

  • 요청 시 다음 로그인 리디렉션 URI를 제공합니다.

    • https://signin.bluebeam.com/oauth2/v1/authorize/callback

    • https://id.bluebeam.com/oidc/callback

    • https://signin.bluebeamstudio.co.uk/oauth2/v1/authorize/callback

    • https://signin.bluebeamstudio.de/oauth2/v1/authorize/callback

    • https://signin.bluebeamstudio.se/oauth2/v1/authorize/callback

    • https://signin.bluebeamstudio.com.au/oauth2/v1/authorize/callback

    • https://id.bluebeam.com/oidctest/callback

  • 필수 사용자 속성을 입력하라는 메시지가 표시되면 다음을 사용합니다.

    • family_name

    • given_name

    • email

    • preferred_username

  • IdP에서 관리하는 모든 사용자가 애플리케이션에 액세스할 수 있는지 확인하세요.

Org Admin에서 SSO 구성에 필요한 정보를 수집하려면 다음과 같이 진행하세요.

  1. IdP에서 다음 정보를 찾아, SSO 구성 과정에서 사용할 수 있도록 다른 곳에 복사해 두세요.

    • 발급자 URI

    • 인증 엔드포인트 URI

    • JWKS URI

    • 애플리케이션 ID(클라이언트 ID)

    • 클라이언트 시크릿

    • 토큰 엔드포인트

    • Userinfo 엔드포인트

  2. IdP에서 기본 인증 서버를 선택합니다.

IdP에서 사용자 목록을 내보내고 사용자를 조정할 준비를 합니다.

SSO 구성의 일환으로, IdP에 등록된 조직 내 사용자와 Bluebeam ID(BBID)를 보유한 조직 내 사용자 목록을 대조해야 합니다 Bluebeam ID(BBID)는 사용자가 계정에 액세스할 수 있는 로그인 정보입니다. BBID를 사용하면 Bluebeam Studio를 비롯한 모든 Bluebeam 솔루션에 하나의 이메일 주소와 비밀번호로 로그인할 수 있습니다. .

대조 작업을 통해 조직 내 사용자의 IdP 내 사용자 ID가 Bluebeam 사용자 데이터베이스의 BBID와 일치하는지 확인합니다. SSO 구현을 시작하기 전에 조직 내 사용자가 직접 BBID와 암호를 선택한 경우, IdP에서 매핑 값으로 선택한 이메일 주소와 일치하지 않는 이메일 주소를 BBID로 사용하고 있을 수 있습니다.

다음 절차에 따라 사용자 목록을 내보내고 SSO 조정 프로세스를 위해 CSV 템플릿에 로드하십시오:

  1. IdP의 안내에 따라 목록을 내보냅니다.
  2. 내보낸 사용자 목록을 열기.
  3. CSV 템플릿을 다운로드하여 열기.
  4. 내보낸 사용자 목록에서 필요한 사용자 정보를 템플릿의 정의된 셀로 복사합니다.

    속성 클레임
    		CSV 템플릿 해당 열
    family_namelastName
    given_namefirstName
    이메일
    또는
    preferred_username    		email

    사용자의 이메일에 SSO를 구성하는 경우, IdP에서 사용자의 이메일 클레임으로 전송하는 값을 당사의 CSV 템플릿에 있는 "email" 열에 복사해야 합니다.

    사용자의 preferred_username에 대해 SSO를 구성하는 경우, IdP가 사용자의 preferred_username 클레임으로 전송하는 값을 당사 CSV템플릿의 "email" 열에 복사해야 합니다.

  5. 파일에서 빈 셀이 포함된 행을 찾아 해당 사용자에게 BBID가 필요한지 확인한 후 다음 작업을 수행합니다.
    • BBID가 필요 없는 사용자의 행에 빈 셀이 나타나면 해당 행을 삭제할 수 있습니다.
    • BBID가 필요한 사용자의 행에 빈 셀이 나타나는 경우:
      1. IdP에서 해당 항목을 찾아 누락된 값을 제공하세요.
      2. IdP에서 사용자 목록을 다시 내보내고 위의 4단계로 이동합니다.
        3. 어떤 사용자에게도 이러한 하위 단계를 수행할 필요가 없는 경우 6단계로 계속 진행하세요.
  6. Org Admin에서 SSO를 구성할 때 사용할 CSV 파일을 저장합니다.

Org Admin에서 SSO 구성

SSO 구성을 완료하려면, IdP에 등록된 조직 내 최종 사용자가 Bluebeam 제품 및 서비스에 SSO로 액세스할 수 있도록 설정하세요. 또한 IdP의 사용자 목록과 BBID를 보유한 당사 시스템의 사용자 목록을 대조해 IdP의 ID가 최종 사용자의 BBID와 일치하도록 해야 합니다.

SSO를 구성하려면 Org Admin 으로 이동하여 다음 단계를 따르세요.

  1. 계정 에서 관리하려는 계정을 선택하세요.

  2. 설정을 선택하세요.

  3. SSO 구성 옆에서 구성을 선택합니다.
  4. OpenID Connect를 선택합니다.
  5. 안내가 표시되면, 다음 요청 정보를 입력합니다. 앞서 SSO 앱에서 수집한: 
    • 발급자
    • 인증 엔드포인트
    • 토큰 엔드포인트
    • JWKS URI
    • Userinfo 엔드포인트
    • 클라이언트 ID
    • 클라이언트 시크릿
  6. 제출을 선택하세요.
  7. OpenID Connect 구성 대화 상자에서 계정에 구성할 검증된 도메인을 지정하고 선택합니다.
  8. “서비스 공급자 속성을 사용 가능한 필드에 매핑”에서 이름 과 성은 기본값을 그대로 유지합니다. 이메일 매핑에서 이메일을 선택하거나, preferred_username에 매핑하는 경우 preferred_username을 선택합니다.
  9. 로그인하여 SSO 테스트를 선택합니다.
  10. 메시지가 나타나면 Studio BBID가 있는 계정을 사용하여 로그인하십시오.
    계속 진행하려면 "연결" 및 "사용자 속성" 테스트가 성공해야 합니다. 선택한 매핑 설정과 "사용자 속성"의 예상 값이 일치하는지 확인하세요.
  11. Org Admin으로 돌아가기.
  12. 계속을 선택하세요.
  13. 다음 을 선택해 사용자 목록을 제공하고 SSO 구성을 완료하세요.

  14. 이전에 생성한 CSV 파일을 업로드하세요.

  15. Next를 선택합니다.

    나중에 완료를 선택하여 진행 상황을 저장하고, 이 절차를 종료하고 나중에 계속 진행하세요.
  16. 메시지가 표시되면, 닫기 를 선택해 SSO 구성을 계속합니다.

설정 탭으로 돌아가서 조직에 대해 선택한 도메인이 표시되는지 확인한 다음 SSO 구성을 계속할 수 있습니다.

당사는 조직 내 BBID를 IdP에 등록된 사용자 ID와 대조합니다. 이 과정이 완료되면 "SSO 구성 계속"이라는 제목의 이메일이 발송되며, 이를 통해 SSO 구성 완료에 필요한 조정 절차를 진행할 수 있습니다.

CSV 파일의 데이터와 관련된 다음과 같은 문제로 인해 파일을 업로드할 때 오류가 발생할 수 있습니다.

  • CSV 파일이 비어 있습니다.
  • CSV 파일을 읽는 중 오류가 발생했습니다.
  • CSV 파일에 필수 열이 하나 이상 누락되었습니다. email, firstName 또는 lastName 열을 찾을 수 없습니다.
  • 행 [행 번호] 주변의 CSV 파일을 읽는 중 문제가 발생했습니다.
  • 행 [행 번호]의 CSV 파일에는 email, firstName 및/또는 lastName 열을 처리하기에 충분한 데이터 열이 포함되어 있지 않습니다.
  • [row number] 행의 CSV 파일에 유효한 이메일 주소(예: jsmith@example.com)가 있어야 할 자리에 유효하지 않은 이메일 주소 "jsmith,"가 포함되어 있습니다.

표시된 오류 메시지의 정보를 사용하여 오류의 원인을 파악하고 오류를 수정한 다음 CSV 파일을 다시 생성하여 업로드하세요.

조직의 BBID와 IdP의 사용자 ID를 조정합니다.

대조 작업을 통해 조직 내 사용자의 IdP 내 사용자 ID가 Bluebeam 사용자 데이터베이스의 BBID와 일치하는지 확인합니다. SSO 구현을 시작하기 전에 조직 내 사용자가 직접 BBID와 암호를 선택한 경우, IdP에서 매핑 값으로 선택한 이메일 주소와 일치하지 않는 이메일 주소를 BBID로 사용하고 있을 수 있습니다.

정합성 검토(Reconciliation)는 사용자의 Studio 데이터에 중점을 둡니다. 조정 절차를 거치지 않고 SSO 구성을 계속 진행하면, 이러한 일치하지 않는 사용자는 기존 Studio 프로젝트 및 세션에 대한 액세스 권한을 잃게 됩니다. 구체적으로, 일치하지 않는 사용자는 다음 항목에 대한 액세스 권한을 잃게 됩니다.

  • 소유하고 있는 활성 Studio 세션 또는 Studio 프로젝트

  • 활성 Studio 세션에서 소유한 마크업

조정(Reconciliation)은 구독 액세스를 관리하거나 사용자의 그룹을 정의하지 않으며, SSO 또는 SCIM 구성 프로세스의 실제 생성에 어떠한 영향도 미치지 않습니다. SSO를 활성화한 후에는 Org Admin을 통해 구독을 관리할 수 있습니다.

"SSO 구성 계속" 이메일이 도착하면 열고 다음 단계를 따르십시오.

  1. Continue SSO Configuration을 선택하여 설정 페이지에서 Org Admin을 엽니다.

  2. "SSO 구성," 옆에서 계속을 선택하여 계정의 사용자 중 데이터베이스의 사용자와 일치하지 않는 사용자 목록을 확인합니다.

  3. "일치하지 않음"으로 표시되는 사용자 정보를 업데이트하거나 무시하십시오.

"일치하지 않음" 목록에는 지난 6개월 동안 Studio에 액세스한 적이 있는 일치하지 않는 사용자가 포함됩니다. 이 목록은 "최근 Studio 로그인"을 기준으로 정렬되므로, 조정을 수행해야 할 가능성이 가장 높은 사용자 우선순위를 지정하는 데 도움이 됩니다. 이 섹션의 나머지 부분에서는 목록에 나타나는 사용자에 관한 질문을 다루고 조정을 완료하기 위해 수행할 수 있는 작업을 설명합니다.

일부 사용자가 "일치하지 않음"으로 표시되는 이유는 무엇입니까?

IdP의 사용자 ID를 Bluebeam 데이터베이스의 ID와 비교하여 대조한 후 일부 사용자가 "일치하지 않음"으로 표시될 수 있습니다. 사용자가 일치하지 않는 것으로 표시되는 이유는 다음과 같은 다양한 원인에 기인할 수 있습니다:

  • 해당 사용자는 더 이상 조직에 소속되어 있지 않습니다.

  • 사용자가 IdP에서 이메일 주소를 변경했지만 Bluebeam 계정에서는 변경하지 않았습니다.

  • 원래 이메일 주소가 잘못 입력되었습니다.

  • 사용자에게 이전 이메일 주소와 연결된 Studio 데이터가 있습니다.

예를 들어 당사에 저장된 BBID 목록에는 조직을 떠났거나, 이름이 변경되었거나, 최초 추가 시 이메일 주소에 오류가 있었던 사용자가 포함되어 있을 수 있습니다. 조정을 통해 "일치하지 않음"으로 표시된 사용자를 검토하여 SSO 액세스 권한을 부여할지 또는 구성 과정에서 해당 사용자를 무시할지 결정할 수 있습니다.

SSO 구성을 계속하려면 일치하지 않는 이메일 주소를 해결하거나 무시해야 합니다.

이 화면이 나타나면 다음을 수행할 수 있습니다.

  • CSV 파일에 수정해야 할 오류가 있는 경우 사용자 목록 다시 업로드 를 선택하세요.

  • 진행 상황을 저장하고 나중에 일치하지 않는 사용자를 처리하려면 '저장하고 나중에 완료'를 선택하세요.

  • 더 이상 조직에 없거나 Bluebeam 제품 및 서비스에 대한 액세스 권한이 필요하지 않아 SSO를 구성하지 않고 무시할 사용자를 한 명 이상 선택합니다.

  • 디렉터리에서 새 Bluebeam ID 필드를 업데이트할 사용자를 한 명 이상 선택합니다. 사용자에게 Bluebeam 제품 및 서비스 구독 액세스가 필요하거나, 조직의 이메일 정보가 변경되었지만 데이터베이스의 BBID는 변경되지 않은 경우이 작업이 필요합니다.

대조를 통해 사용자의 BBID와 IdP 로그인 자격 증명이 일치하도록 연결합니다. 사용자의 현재 BBID를 IdP 로그인 자격 증명과 일치하도록 업데이트하는 경우, 해당 사용자는 앞으로 IdP 자격 증명을 사용하여 당사 서비스에 액세스해야 합니다. 해당 사용자에게 연락하여 조직 자격 증명을 새 BBID로 사용하도록 안내하고, 필요한 경우 세션(Sessions)에서 로그아웃한 후 새 BBID를 사용하여 다시 로그인하도록 안내하십시오.

사용자가 여러 번 나타나는 이유는 무엇입니까?

사용자가 여러 번 나타나지만 Studio 지역이 다른 경우 각 지역별로 해당 사용자를 조정하여 해당 Studio 프로젝트 나 Studio 세션 에 대한 액세스 권한을 잃지 않도록 하세요.

"사용자 무시"를 해야 할 때

일치하지 않는 사용자 중 상당수는 조직에 더 이상 없거나 BBID가 필요 없는 사용자입니다. 일치하지 않는 사용자 목록이 나타나면, 일치하지 않는 사용자의 현재 BBID 옆에 있는 정보 아이콘() 위로 마우스를 가져가 해당 Studio 활동을 검토하세요. 표시되는 정보는 다음과 같습니다:

  • 마지막 Studio 로그인
  • 소유 세션
  • 참여 세션
  • 소유 프로젝트
  • 프로젝트 멤버십

사용자가 전직 직원이거나 Bluebeam 제품 및 서비스에 대한 SSO 액세스가 필요하지 않다고 판단되면 "일치하지 않음"을 선택한 다음 "사용자 무시"를 선택하여 조직의 SSO 구성에서 해당 사용자를 제외합니다.

사용자를 두 명 이상 무시하려면 여러 사용자를 선택하고 "사용자 무시"를 선택합니다.

"디렉터리에서 가져온 새 Bluebeam ID"를 편집해야 하는 경우

사용자를 업데이트해야 하는 경우, 편집을 선택하고 "일치하지 않음"을 선택한 다음 IdP에서 사용자의 이메일 주소를 제공합니다. 일치하는 정보를 업데이트한 후, 사용자에게 앞으로 새로운 BBID를 사용해야 하며, 필요한 경우 로그아웃한 후 새로운 BBID를 사용하여 다시 로그인해야 함을 알리세요.

모든 사용자 표시를 선택하여 목록에 있는 모든 사용자가 "무시" 또는 "변경 없음"으로 표시되는지 확인하세요.

SSO 활성화

일치하지 않는 사용자를 무시하거나 업데이트한 후 활성화를 선택해 SSO 구성을 완료합니다.

SSO 비활성화

조직에서 SSO를 비활성화해야 하는 경우 Org Admin을 사용하세요.

조직의 SSO 비활성화

필요한 경우 조직의 SSO를 비활성화할 수 있습니다. 이 작업은 쉽게 되돌릴 수 없으므로 확실히 진행하시기 바랍니다.

SSO를 비활성화하면 다음이 발생합니다.
  • SSO 설정 중에 이루어진 모든 구성이 손실됩니다.
  • 조직의 SSO 공급자를 사용하여 사용자가 Bluebeam 제품에 로그인할 수 없습니다.
  • 사용자는 BBID와 비밀번호를 사용하여 Bluebeam 제품에 로그인해야 합니다.
  • 모든 사용자 ID는 accounts.bluebeam.com 을 통해 개별적으로 관리해야 합니다.

SSO를 비활성화하려면 다음 단계를 따르세요.

  1. Org Admin의 왼쪽 사이드바 메뉴에서 설정을 선택합니다.
  2. SSO 구성 옆에 있는 토글을 끕니다.