InfoGrab DocsInfoGrab Docs

인스턴스 SSH 인증서 API

인스턴스 SSH 인증 기관 공개 키를 나열, 추가, 삭제하는 REST API를 설명합니다.

히스토리 GitLab 19.5에서 instance_ssh_certificates 라는 기능 플래그 와 함께 도입되었습니다 . 기본적으로 사용 중지되어 있습니다. Feature flag 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다. 이 기능은 테스트용으로 사용할 수 있지만 프로덕션 사용에는 아직 적합하지 않습니다. 이 API를 사용하여 인스턴스가 신뢰하는 SSH 인증 기관(CA) 공개 키를 관리합니다. GitLab은 각 CA 공개 키를 데이터베이스에 저장하고 인스턴스 전체에서 신뢰하므로, sshd_config 나 gitlab-sshd 구성 파일을 변경하지 않고 API 호출로 CA를 교체할 수 있습니다. 파일 기반 대안은 gitlab-sshd 를 사용한 인스턴스 수준 SSH 인증서 를 참고합니다. key 속성에는 개인 키나 서명된 사용자 인증서가 아니라 CA 공개 키가 들어갑니다. 인증 및 사용 가능 여부 # 모든 엔드포인트는 REST API 로 인증된 관리자가 필요합니다. 인스턴스에서 Admin Mode가 활성화된 경우 개인 액세스 토큰 또는 OAuth 토큰의 admin_mode 스코프를 포함해 기존 Admin Mode 요구 사항 이 적용됩니다. GitLab은 기능 사용 가능 여부보다 먼저 인증과 관리자 액세스를 확인합니다. 다음 오류는 기능 플래그가 비활성화된 경우에도 모든 엔드포인트에 적용됩니다. 상태 설명 401 Unauthorized 요청이 인증되지 않았습니다. 403 Forbidden 인증된 사용자에게 관리자 액세스 권한이 없습니다. 404 Not Found 사용자에게 관리자 액세스 권한이 있지만 기능을 사용할 수 없습니다. 모든 인스턴스 SSH 인증서 목록 조회 # 모든 인스턴스 SSH CA 공개 키 레코드를 ID 내림차순으로 나열합니다. GET /admin/ssh_certificates 이 엔드포인트는 표준 페이지네이션 을 지원합니다. 속성 타입 필수 여부 설명 page integer 아니요 조회할 페이지. 기본값: 1 . per_page integer 아니요 페이지당 레코드 수. 기본값: 20 . 최댓값: 100 . 성공하면 200 OK 와 다음 응답 속성을 가진 객체의 배열을 반환합니다. 속성 타입 설명 created_at string 레코드가 생성된 날짜와 시간(ISO 8601 형식). fingerprint string SSH CA 공개 키의 SHA256 지문. id integer 인스턴스 SSH 인증서 레코드의 ID. key string SSH CA 공개 키. title string 레코드의 제목. 요청 예시: curl --request GET \ --header "PRIVATE-TOKEN: <your_access_token>" \ --url "https://gitlab.example.com/api/v4/admin/ssh_certificates?page=1&per_page=20" 응답 예시( <ca_public_key> 는 전체 SSH CA 공개