Shotgun의 SSO: 사용자 안내서

SSO(단일 로그온)란?

SSO(단일 로그온)는 조직에서 사용되는 응용프로그램 및 서비스에 대한 액세스를 중앙에서 제어하기 위해 사용됩니다. 사용자의 관점에서 보면 각 서비스에 대해 인증받을 필요가 없으므로 작업이 간소화됩니다.

Shotgun 사이트가 SSO를 사용하도록 구성되면 사이트와의 상호 작용 방식이 기본 로그인 흐름에서 조금 변경됩니다.

브라우저에서 Shotgun 사이트 액세스

Shotgun 사이트의 URL로 이동하면 일반적인 로그인/암호 페이지 대신 다음 페이지가 표시됩니다. Shotgun에 액세스하는 대신 회사 자격 증명이 사용된다는 것을 알려 줍니다.

Shotgun 로그인
Shotgun 로그인

Windows 환경의 SSO 로그인(데스크톱 SSO 통합)

Windows 환경에서 작업하는 경우 대부분 자격 증명을 입력할 필요가 없습니다. 필요한 정보가 컴퓨터의 현재 Windows 세션에서 서버로 자동 전송됩니다. 이를 '데스크톱 SSO 통합'이라고 합니다.

다른 환경의 SSO 로그인

Linux와 Mac, 그리고 일부 Windows의 경우 자격 증명을 묻는 메시지가 나타납니다. 사용자에게 표시되는 GUI(그래픽 사용자 인터페이스)는 사용되는 SSO 시스템에 따라 다르며 회사 로고 및 기타 정보로 커스터마이즈할 수 있습니다.

예를 들어 회사에서 SSO에 대해 Okta를 사용하는 경우 다음과 같이 표시됩니다.

Okta 로그인
Okta 로그인

로그인 실패

잘못된 자격 증명 정보를 입력하거나 Shotgun에 대한 액세스 권한이 부여되지 않은 경우 SSO 시스템이나 Shotgun에서 오류 메시지가 표시됩니다. 이는 회사에서 사용하는 SSO 시스템에 따라 다릅니다.

다음은 액세스가 거부되는 두 가지 예입니다.

SSO 시스템 레벨에서 차단

이 오류 메시지는 사용자의 자격 증명에 Shotgun에 대한 액세스 권한이 없는 경우 SSO 시스템에서 표시합니다.

이 문제를 해결하려면 Shotgun 관리자에게 문의해야 합니다.

Okta 액세스 권한 없음
Okta 액세스 권한 없음

Shotgun 레벨에서 차단

자격 증명이 올바르지만 Shotgun에 대한 액세스 권한이 없는 경우 다음 오류가 발생합니다.

이 문제를 해결하려면 Shotgun 관리자에게 문의해야 합니다.

Shotgun 액세스 권한 없음
Shotgun 액세스 권한 없음

SSO를 사용한 첫 번째 연결

SSO를 지원하는 Shotgun 사이트에 처음 연결하려면 몇 가지 추가적인 단계가 필요할 수 있습니다. 걱정하지 마십시오. 이 작업은 한 번만 수행하면 됩니다. 이후 방문부터는 원활하게 진행됩니다.

SSO를 켜기 전에 Shotgun 계정이 이미 있는 경우

Shotgun 관리자가 모든 것을 구성하는 것이 이상적입니다. 사용자는 Shotgun 사이트에 직접 연결하여 즉시 작업할 수 있어야 합니다.

이 경우 Shotgun 사이트에서 SSO가 활성화되었다는 내용의 이메일을 받게 됩니다.

Shotgun SSO 활성화됨
Shotgun SSO 활성화됨

Shotgun 계정이 있지만 잘못된 경우

Shotgun 관리자가 가능한 한 원활하게 SSO로 전환할 수 있도록 모든 조치를 취했어도 여전히 오류 또는 문제가 발생할 수 있습니다. 세 가지 상황이 가능합니다.

  1. 사용자가 Shotgun에 존재하지 않습니다. 첫 번째 상황이 발생하면 다음 메시지가 표시됩니다. Shotgun 사용자 없음
    이 오류는 일반적으로 이전 Shotgun 로그인이 SSO 시스템에서 보낸 로그인 정보와 일치하지 않을 때 발생합니다. Shotgun 관리자는 두 계정이 일치하도록 하거나 링크되도록 해야 합니다.
    이 문제를 해결하려면 Shotgun 관리자에게 문의해야 합니다.
  2. Shotgun의 이메일 주소가 SSO 시스템에서 제공한 이메일과 일치합니다. 계정을 수동으로 링크하라는 메시지가 나타납니다. Shotgun 계정 링크 이메일 일치
    다음 두 가지 방법이 있습니다.
    • SSO 계정을 Shotgun 계정에 링크합니다. 신원을 증명하기 위해 Shotgun 계정의 암호를 제공하라는 메시지가 표시됩니다. 암호를 잊어버린 경우 언제든지 '로그인 또는 암호를 잊으셨습니까(Forgot login or password)' 링크를 클릭할 수 있습니다.

      Shotgun 계정 링크 암호
      Shotgun 계정 링크 암호

    • 계정 링크를 건너뛰도록 선택할 수도 있습니다. 이 단계는 권장하지 않습니다. 계정을 링크하지 않으면 새로운 사용자가 만들어집니다. 이 새로운 사용자는 이전 계정에 연결되어 있지 않으므로 이전 특권 및 액세스 권한이 부여되지 않습니다.
      이 문제를 해결하려면 Shotgun 관리자에게 문의해야 합니다.
    • 기존 사용자 목록에 일치하는 항목이 없습니다. Shotgun의 기존 사용자 계정에 계정을 수동으로 링크하라는 메시지가 표시됩니다.Shotgun 계정 링크 일치하는 항목 없음
      다음 두 가지 방법이 있습니다.
      • SSO 계정을 기존 Shotgun 계정에 링크합니다. 신원을 증명하기 위해 계정의 사용자 이름과 암호를 제공하라는 메시지가 표시됩니다. 암호를 잊어버린 경우 언제든지 '로그인 또는 암호를 잊으셨습니까(Forgot login or password)' 링크를 클릭할 수 있습니다. Shotgun 계정 링크 사용자 이름 암호
      • 계정 링크를 건너뛰도록 선택할 수도 있습니다. 이 단계는 권장하지 않습니다. 계정을 링크하지 않으면 새로운 사용자가 만들어집니다. 이 새로운 사용자는 이전 계정에 연결되어 있지 않으므로 이전 특권 및 액세스 권한이 부여되지 않습니다.
        이 문제를 해결하려면 Shotgun 관리자에게 문의해야 합니다.

기존 Shotgun 계정이 없는 경우

Shotgun 관리자가 적절한 로그인 이름과 필요한 프로젝트에 대한 액세스 권한으로 사용자를 만드는 것이 이상적입니다. 이 경우 Shotgun에 직접 연결해야 합니다.

다음과 같은 경우 Shotgun 사이트로 안내하는 이메일을 받게 됩니다.

Shotgun SSO 초대
Shotgun SSO 초대

'초대 수락(Accept invitation)'을 클릭하면 자동으로 로그인됩니다.

다음 페이지에서 이 사이트에 대한 첫 번째 계정이라는 답변을 선택하고 로그인을 계속 진행합니다.

Shotgun 계정 링크 일치하는 항목 없음
Shotgun 계정 링크 일치하는 항목 없음

Shotgun에 직접 액세스하지 않고 계정 링크 또는 새 사용자 생성을 요청받은 경우

예기치 않은 오류가 발생하거나 기존 계정에 링크하라는 메시지가 표시되면 어딘가 잘못되었다는 증거입니다. Shotgun 관리자가 분명하게 지시하지 않는 한 계속 진행하지 마십시오. 잘못 조작하면 원치 않는 결과가 발생하고 추가적인 지연이 발생할 수 있습니다.

이 문제를 해결하려면 Shotgun 관리자에게 문의해야 합니다.

RV에서 Shotgun 사이트 액세스

스튜디오에서 RV를 사용하는 경우 SSO를 지원하는 Shotgun 사이트에 연결하려면 버전 7.2.2 이상을 사용해야 합니다.

먼저 브라우저를 사용하여 Shotgun 서버에 대한 연결을 시도하는 것이 좋습니다. 이는 다른 방법을 사용하여 Shotgun에 로그인하는 적절한 액세스 권한이 있음을 확인하기 위한 것입니다.

다음 연결 대화상자가 표시되면 'SSO 사용(Use Single Sign-On (SSO))' 링크를 클릭합니다.

RV 연결
RV 연결

그러면 다음 대화상자로 전환됩니다.

RV 연결 SSO
RV 연결 SSO

‘계속(Continue)’을 클릭합니다.

문제가 발생하면 로그인 실패 섹션을 참조하십시오. 또한 예기치 않은 동작이 발생할 경우 Shotgun 관리자에게 문의하는 것이 좋습니다.

Shotgun 데스크톱으로 Shotgun 사이트 액세스

스튜디오에서 Shotgun 데스크톱을 사용하는 경우 SSO를 지원하는 Shotgun 사이트에 연결하려면 버전 1.5.0 이상을 사용해야 합니다.

먼저 브라우저를 사용하여 Shotgun 서버에 대한 연결을 시도하는 것이 좋습니다. 이는 다른 방법을 사용하여 Shotgun에 로그인하기 전에 적절한 액세스 권한이 있음을 확인하기 위한 것입니다.

다음 연결 대화상자가 표시되면 사이트의 URL을 입력합니다.

SG 데스크톱 로그인
SG 데스크톱 로그인

이 대화상자에서는 사이트에서 SSO를 사용하는지 자동으로 탐지합니다.

SG 데스크톱 로그인 SSO
SG 데스크톱 로그인 SSO

'로그인(Sign in)'을 클릭하여 계속 진행합니다.

문제가 발생하면 로그인 실패 섹션을 참조하십시오. 또한 예기치 않은 동작이 발생할 경우 Shotgun 관리자에게 문의하는 것이 좋습니다.

내부 도구 및 타사 응용프로그램으로 Shotgun 사이트 액세스

스튜디오에서 Shotgun에 액세스하는 데 사용하는 내부 도구 또는 타사 응용프로그램이 SSO를 지원하도록 수정해야 합니다.

Shotgun 사이트에서 SSO를 활성화하기 전에 관리자는 환경을 전환할 준비가 되었는지 확인해야 합니다.

내부 도구 및 타사 응용프로그램에 문제가 발생하면 Shotgun 관리자에게 문의하십시오.

문제 해결

SSO가 비활성화되었다는 이메일을 받은 경우

Shotgun 관리자가 SSO를 비활성화했을 수 있습니다. 제일 먼저 받는 영향은 SSO를 활성화하기 전에 사용했던 Shotgun 자격 증명을 기억해야 한다는 것입니다.

다음과 같은 두 가지 가능한 시나리오가 있습니다.

  1. SSO를 활성화하기 전에 Shotgun 계정이 없었던 경우. 이 경우 다음과 같은 이메일을 받게 됩니다. Shotgun SSO 비활성화됨 암호 재설정
    계속하려면 '암호 재설정(Reset your password)' 링크를 클릭합니다.
  2. SSO를 활성화하기 전에 Shotgun 계정이 있었던 경우. 이 경우 다음과 같은 이메일을 받게 됩니다. Shotgun SSO 비활성화됨
    메시지에서 안내하듯이 이전 자격 증명을 기억해야 합니다. 암호를 잊은 경우 로그인 페이지에서 '로그인 또는 암호를 잊으셨습니까(Forgot login or password)' 링크를 클릭하여 암호를 재설정할 수 있습니다.

모든 프로젝트에 액세스할 수 없는 경우

Shotgun 서버에 성공적으로 액세스할 수 있지만 다음 페이지가 표시됩니다.

Shotgun 프로젝트 없음
Shotgun 프로젝트 없음

다음과 같은 두 가지 가능한 시나리오가 있습니다.

  1. 새 사용자인 경우 Shotgun 관리자가 사용자를 프로젝트에 할당하지 않았을 수 있습니다.
  2. 이전에 Shotgun 계정이 있었던 경우 누락되거나 잘못 구성된 것일 수 있습니다.

두 경우 모두 Shotgun 관리자에게 문의하여 문제를 해결하십시오.

Shotgun에 로그인한 후 작은 팝업 창이 계속 표시되는 경우

Shotgun에 로그인한 후 다음과 같은 브라우저 창이 나타날 수 있습니다.

SSO 갱신 창
SSO 갱신 창

이는 정상적인 현상입니다. 메시지에 나온 대로 이 창을 닫지 마십시오. 이 창은 Shotgun과 SSO 시스템을 통해 사용자를 지속적으로 인증하는 데 사용됩니다. 창을 닫으면 나중에 자동으로 다시 열립니다. 이 경우 브라우저에서 팝업이 열리도록 승인해야 할 수도 있습니다(Shotgun에서 새 창을 열도록 허용하라는 메시지가 나타나는 경우 참조).

이 팝업 창은 SSO 시스템에 연결된 제약 조건이 있기 때문에 나타납니다.

Shotgun에서 로그아웃하면 창이 자동으로 닫힙니다.

Shotgun에서 새 창을 열도록 허용하라는 메시지가 나타나는 경우

참고: Shotgun에 로그인한 후 작은 팝업 창이 계속 표시되는 경우

Shotgun에 처음 연결된 후 열린 창을 닫으면 다음 메시지가 표시될 수 있습니다.

Shotgun 팝업 차단됨
Shotgun 팝업 차단됨

사이트를 사용하려면 Shotgun에서 새 창을 열 수 있도록 허용해야 합니다.

Shotgun에서 새 창을 열 수 있도록 허용하는 메커니즘은 브라우저에 따라 다릅니다. Google Chrome에서는 주소 표시줄에 빨간색 알림이 표시됩니다. 클릭하면 다음 메뉴가 나타납니다.

Shotgun 팝업 차단됨
Shotgun 팝업 차단됨

항상 팝업을 허용하는 옵션을 선택하고 '완료(Done)'를 클릭한 다음 알림 창에서 '확인(OK)'을 클릭합니다.

화면의 왼쪽 하단에 작은 Shotgun 창이 나타납니다.

로그인 후 아무 창도 닫지 않은 경우 구성이 잘못된 상태이므로 Shotgun 관리자에게 문의하십시오.

가끔 Shotgun에 로그인할 수 없는 경우

로컬 컴퓨터 시계가 정확하지 않을 수 있습니다. 컴퓨터 시계와 Shotgun 또는 SSO 서버 시계의 근소한 차이로 인해 문제가 발생할 수 있습니다.

시계 왜곡을 쉽게 식별하려면 time.is 사이트를 방문하십시오.

왼쪽 상단에 시간이 맞는지 여부가 표시됩니다. 시간 정상

또는 시간이 크게 왜곡되었는지도 표시됩니다. 시간 정상

문제가 지속되면 시스템 관리자에게 문의하여 컴퓨터 시계를 수정하거나 Shotgun 관리자에게 문의하십시오.

RV에서 내 세션이 오래 지속되지 않는 경우

SSO를 활성화하면 세션 기간이 더 이상 Shotgun이나 RV에 의해 제어되지 않습니다. SSO 백엔드와 IT 부서에 의해 제어됩니다.

Shotgun에 로그인할 때 일관성 없는 동작이 계속 나타나는 경우

이러한 동작에는 비연속적 액세스 또는 계정을 링크하거나 새 계정을 만들라는 요청이 포함될 수 있습니다.

이전 세션의 정보가 일부 남아 있을 수도 있습니다.

사용자를 위해 브라우저의 쿠키를 모두 지우는 것이 좋습니다. 이 방법은 사용하는 브라우저에 따라 다릅니다. 적절한 도움말 문서를 참조하십시오.

문제가 지속되면 Shotgun 관리자에게 문의하십시오.

팔로우

0 댓글

댓글을 남기려면 로그인하세요.