dashboarddone_allaccount_tree로컬 계정
Semaphore 사용자 이름과 암호로 로그인하세요.
팀 접근 및 로그인 설정
팀에서 프로젝트 역할을 할당하세요. 엔지니어의 책임에 따라 작업 실행, 결과 검토, 설정 관리를 허용할 수 있습니다.
특정 책임을 위한 역할을 만드세요. 선택한 작업으로 접근을 제한해야 한다면 프로젝트 전체 권한은 끄세요.
작업 템플릿에 역할을 추가하고 설정 편집은 허용하지 않은 채 실행만 허용합니다.
Enterprise에서 ID 프로바이더 그룹을 프로젝트 역할에 매핑하세요. Semaphore는 다음 로그인에서 매핑된 접근을 갱신합니다.
계정 → 보안을 열어 로컬 로그인용 인증 앱을 설정하세요. 같은 화면에서 외부 ID도 연결합니다.
기존 디렉터리로 로그인
기존 ID 시스템을 로그인에 연결하세요. 각 사람이 접근할 수 있는 리소스와 동작은 Semaphore 프로젝트 역할이 결정합니다.
LDAP 및 Active Directory
기존 디렉터리 자격 증명으로 로그인하게 하세요.
OpenID Connect
Keycloak, Okta, Microsoft Entra ID, Authentik 또는 다른 OIDC 프로바이더를 연결하세요.
신뢰하는 프록시의 JWT
신뢰하는 인증 프록시에서 서명된 ID 토큰을 받습니다.
2단계 인증으로 로컬 로그인 보호
로컬 계정의 인증 앱 코드를 활성화하고 복구와 세션 유효 시간을 설정하세요. 사용자가 자신의 두 번째 인증 요소를 등록합니다.
인증 앱 코드로 로그인 시 두 번째 인증 요소를 추가합니다.
인증 앱을 사용할 수 없을 때 복구할 수 있도록 합니다.
설정된 최대 유효 시간이 지나면 새 로그인을 요구합니다.
일상 접근용 프로젝트 역할
모든 권한을 처음부터 설정하지 않고 프로젝트 구성원에게 기본 역할을 할당하세요. 한 사람이 여러 역할을 가질 수 있으며 권한은 합산됩니다.
팀을 위한 역할 생성
Enterprise에서는 팀의 책임을 중심으로 사용자 지정 역할을 정의하세요. 모두에게 똑같이 넓은 접근을 주는 대신 수행 가능한 동작을 선택합니다.
역할을 선택한 작업으로 제한
프로젝트의 모든 작업 대신 특정 작업 템플릿에 접근하도록 사용자 지정 역할을 부여하세요. 템플릿 편집과 분리하여 작업 실행을 허용합니다.
같은 접근 방식이 워크플로에도 적용되며 실행, 편집, 승인 권한은 별도입니다.
팀이 준비된 작업을 실행하도록
준비된 작업 위임
작업 템플릿
실행 기록 보관
실행 기록 및 로그자동화를 보고 실행하고 변경할 사람 정의
역할을 제한하기 전에 작업 준비
위임할 작업에는 리포지토리, 인벤토리, 자격 증명 참조가 이미 저장된 작업 템플릿을 사용합니다. 먼저 만들고 테스트한 다음 실행을 허용할 역할을 만드세요. 실제 사용자와 동등한 계정으로 로그인하여 의도한 작업은 시작할 수 있고 다른 작업은 사용할 수 없는지 모두 확인하세요.
워크플로 단계 승인에는 별도 권한 필요
워크플로 권한은 보기, 실행, 편집, 승인을 포함합니다. 승인은 실행과 별도이므로 작업을 시작하는 사람과 대기 단계를 진행시키는 사람을 같게 할지 결정할 수 있습니다. 두 권한을 기본으로 함께 주지 말고 의도적으로 할당하세요.
그룹 매핑은 다음 로그인 시 적용
Enterprise 그룹 매핑은 프로바이더가 보내는 groups 클레임으로 OIDC 그룹과 Semaphore 프로젝트 역할을 연결합니다. Semaphore는 사용자가 로그인할 때 매핑된 역할을 갱신합니다. 디렉터리 그룹에서 사용자를 제거해도 이미 유지 중인 세션은 끝나지 않으므로 해당 시점을 고려해 권한 회수를 계획하세요.
로컬 관리자 복구 경로 유지
일상 로그인이 외부 프로바이더에 의존하면 테스트된 로컬 관리자 계정 하나를 함께 유지하세요. 책임자와 자격 증명 위치를 기록하고 장애 전에 해당 경로를 사용해 보세요. 이후 복구 중 부여된 접근을 검토하여 임시 변경이 영구화되지 않게 하세요.
개별 권한은 작업 템플릿과 워크플로에 적용
선택 객체 권한은 두 종류의 객체에 적용됩니다. 개별 인벤토리, 리포지토리, 변수 그룹, Key Store 항목은 이 방식으로 관리되지 않으며 프로젝트 전체 권한과 프로젝트 자체 경계 아래에 있습니다. 더 좁은 리소스 제어에 의존하는 요구 사항은 프로세스를 구축하기 전에 검증하세요.
할당된 모든 역할의 권한 합산
팀원은 기본 역할과 사용자 지정 역할, 전역 역할과 프로젝트 역할을 동시에 여러 개 가질 수 있습니다. 실제 접근 권한은 이들 모두의 합집합이므로 다른 곳에서 부여한 넓은 역할이 세심하게 제한한 역할의 효과를 없앨 수 있습니다. 제한에 의존하기 전에 전체 역할을 확인하세요.
문서 및 관련 기능
FAQ
인증과 프로젝트 권한은 어떻게 다른가요?
인증은 로컬 계정이나 지원되는 외부 ID 시스템을 통해 누가 로그인하는지 확인합니다. 인가는 해당 Semaphore 사용자가 접근할 수 있는 프로젝트와 동작을 결정합니다. SSO 활성화만으로 올바른 운영 역할이 할당되지는 않습니다. 두 가지를 함께 설계하세요. ID 연결을 확인하고 의도한 프로젝트 구성원 자격을 추가한 뒤, 운영 작업을 위임하기 전에 실제 사용자와 동등한 계정에서 사용할 수 있는 동작을 테스트하세요.
Task Runner가 선택한 템플릿 하나만 실행하도록 할 수 있나요?
기본 Task Runner 역할은 프로젝트의 모든 템플릿을 실행할 수 있습니다. 선택한 작업만 위임하려면 선택한 작업 템플릿과 워크플로의 권한이 있고 프로젝트 전체 실행 권한은 없는 Enterprise 사용자 지정 역할을 사용하세요. 모든 할당 역할의 권한이 합산되므로 함께 보유한 더 넓은 역할이 다른 템플릿 실행도 허용할 수 있습니다.
사용자 지정 역할을 선택한 작업 템플릿과 워크플로로 제한할 수 있나요?
네. Enterprise 사용자 지정 역할은 프로젝트 전체 권한과 개별 객체 권한을 결합합니다. 프로젝트 전체 권한은 끄고 필요한 작업 템플릿과 워크플로만 추가하여 각각 보기, 실행, 편집 및 워크플로 승인을 선택하세요. 전역 역할은 한 번 정의해 프로젝트 간 재사용하고 프로젝트 역할은 만든 프로젝트 안에 머뭅니다. 사용자는 여러 역할을 가질 수 있고 권한은 합산되므로 민감한 자동화 접근을 제한할 때 전체를 검토하세요.
권한을 인벤토리 하나나 자격 증명 항목 하나로 제한할 수 있나요?
개별 객체 수준 제어는 작업 템플릿과 워크플로에 적용됩니다. 인벤토리, 리포지토리, 변수 그룹, Key Store 항목의 프로젝트 전체 관리 권한을 그중 하나로 좁힐 수 있다고 가정하지 마세요. 운영 책임을 분리할 때 프로젝트 경계와 사용 가능한 역할 모델을 의도적으로 사용하세요. 다른 종류의 리소스 수준 제한에 접근 설계가 의존한다면 프로덕션에서 사용하기 전에 정확한 요구 사항을 검증하세요.
Semaphore에서 LDAP, Active Directory, OIDC, JWT 로그인을 사용할 수 있나요?
문서화된 인증 옵션은 로컬 계정, LDAP 및 Active Directory, OpenID Connect, 신뢰하는 리버스 프록시에서 전달되는 JWT이며 제공 여부는 현재 플랜 비교에 표시됩니다. 외부 인증 사용자도 Semaphore 사용자 기록이 있으며 의도한 프로젝트 접근이 필요합니다. 기존 설정을 바꾸기 전에 프로바이더 식별자와 계정 연결 동작을 확인하세요. ID 프로바이더를 활성화하면 모든 디렉터리 그룹이 인가 설계에 필요한 역할에 자동 매핑된다고 가정하지 마세요.
ID 프로바이더를 사용할 수 없으면 어떻게 복구해야 하나요?
외부 인증 설정과 함께 테스트된 로컬 관리자 복구 경로를 유지하세요. 책임자, 필요한 자격 증명의 보관 위치, 장애 중 접근 방법을 문서화하세요. 모든 관리자가 같은 사용 불가능한 프로바이더에 의존한다는 사실을 인시던트 중에 발견하지 않도록 미리 테스트하세요. 복구 후 관련 계정과 프로젝트 접근을 검토하여 임시 운영 변경이 의도치 않은 영구 권한이 되지 않게 하세요.
동료가 플레이북이나 템플릿을 편집하지 않고 작업을 실행할 수 있나요?
네. 기본 Task Runner 역할은 다른 리소스를 읽기 전용으로 유지하면서 프로젝트 템플릿을 실행할 수 있습니다. 선택한 작업에 접근하려면 해당 작업 템플릿과 워크플로에 권한이 있는 Enterprise 사용자 지정 역할을 사용하세요. 권한은 합산되므로 구성원에 할당된 모든 역할을 확인하세요. 준비된 작업 템플릿은 팀이 사용할 실행 설정을 유지합니다.
작업 시작 권한 없이 결과만 검토하게 할 수 있나요?
Guest 역할은 읽기 전용 프로젝트 접근을 제공합니다. 게스트는 작업을 실행하거나 설정을 변경하지 않고 프로젝트 정보와 작업 결과를 확인할 수 있습니다. 적절한 프로젝트 팀에 사용자를 추가하고 다른 역할도 검토하세요. Guest와 함께 할당된 더 넓은 역할이 추가 권한을 부여할 수 있습니다.
ID 프로바이더 그룹으로 프로젝트 역할을 자동 할당할 수 있나요?
Enterprise 그룹 매핑은 OIDC 프로바이더 그룹을 Semaphore 프로젝트 역할과 연결합니다. 프로바이더에서 groups 클레임을 설정하고 대상 프로젝트와 역할의 매핑을 추가하세요. Semaphore는 해당 프로바이더로 로그인할 때 할당을 갱신하므로 기존 세션에 즉시 적용되는 대신 다음 로그인에서 변경이 적용됩니다.
로컬 계정을 2단계 인증으로 보호할 수 있나요?
네. 서버 설정에서 TOTP를 활성화하면 사용자가 로컬 계정에 인증 앱을 등록하고 암호 다음에 시간 기반 코드를 입력할 수 있습니다. 등록 시 인증 앱이 없을 때 로그인할 복구 코드가 생성됩니다. 옵션을 켜도 모든 계정에 등록을 강제하지는 않으므로 도입을 프로세스로 다루세요. 같은 설정 영역에서 활동 여부와 무관하게 고정 수명 후 세션을 끝내는 최대 유효 시간도 지정합니다.