GitLab 토큰 문제 해결

GitLab 토큰 문제 해결에 대해 설명합니다.

GitLab 토큰 작업 중 다음과 같은 문제가 발생할 수 있습니다. 토큰이 활성 상태로 보이지만 요청이 실패함 # 활성으로 표시된 토큰도 401 Unauthorized , 403 Forbidden 또는 404 Not Found 응답을 반환할 수 있습니다. 활성 상태는 토큰이 존재하며 만료되거나 취소되지 않았다는 것만 나타냅니다. 이 상태가 토큰으로 특정 요청을 할 수 있다는 의미는 아닙니다. 토큰의 권한은 스코프와 역할에 따라 달라집니다. 요청은 토큰 외적인 이유로도 실패할 수 있습니다. 요청이 어디에서 오는지, 요청이 어떤 리소스를 대상으로 하는지, 관리자가 액세스 토큰을 껐는지 등입니다. 이러한 요소는 토큰 자체로는 알 수 없습니다. 개인, 프로젝트, 그룹 액세스 토큰은 모두 동일한 glpat- 접두사를 사용합니다. 따라서 동일해 보이는 두 토큰이 서로 다르게 동작할 수 있습니다. 활성 토큰은 다음과 같은 이유로 실패할 수 있습니다: 원인 해결 방법 요청에 필요한 스코프가 토큰에 없습니다. 필요한 액세스 토큰 스코프를 가진 토큰을 만드세요. 교체는 원래 스코프를 유지하며 없는 스코프를 추가할 수 없습니다. 그룹 또는 프로젝트 액세스 토큰에 필요한 역할이 없습니다. 더 높은 역할의 토큰을 만드세요. 토큰의 권한은 역할과 스코프 모두에 의해 제한됩니다. 토큰이 만료되었습니다. 액세스 토큰은 만료 날짜의 UTC 자정에 만료됩니다. 토큰을 만든 다음 이전 토큰을 사용하던 모든 위치를 업데이트하세요. 토큰이 취소되었거나, 교체되었지만 원래 값이 계속 사용되고 있습니다. 교체하면 원래 토큰은 즉시 비활성화됩니다. 교체로 생성된 토큰을 사용하거나 토큰을 새로 만드세요. GitLab Self-Managed 및 GitLab Dedicated에서는 관리자가 실수로 취소된 개인 액세스 토큰을 복원할 수 있습니다. 해당 토큰 유형으로는 리소스에 액세스할 수 없습니다. 리소스에 액세스할 수 있는 토큰 유형을 사용하세요. 개인 액세스 토큰은 해당 사용자가 사용할 수 있는 그룹과 프로젝트에 액세스합니다. 그룹 액세스 토큰은 해당 그룹의 하위 그룹과 프로젝트에 액세스합니다. 프로젝트 액세스 토큰은 자신의 프로젝트에만 액세스합니다. IP 주소 제한이 요청을 차단합니다. 이 제한은 그룹 및 프로젝트 액세스 토큰에 적용되며, 차단된 요청은 404 Not Found 를 반환합니다. 허용된 주소에서 요청을 보내거나, 최상위 그룹의 Owner 역할을 가진 사용자에게 해당 주소를 허용 범위에 추가하도록 요청하세요. 외부 인가가 켜져 있습니다. 개인 및 프로젝트 액세스 토큰은 컨테이너 레지스트리나 패키지 레지스트리에 액세스할 수 없습니다. 레지스트리에 대한 액세스를 복원하려면 외부 인가를 끄세요. 관리자가 인스턴스의 액세스 토큰을 껐습니다. 관리자 또는 Owner 역할을 가진 사용자에게 액세스 토큰을 다시 켜도록 요청하세요. 어떤 원인이 적용되는지 확인하려면 실패한 토큰의 세부 정보를 정상 동작하는 토큰과 비교하세요: 개인 액세스 토큰 그룹 액세스 토큰 프로젝트 액세스 토큰