모든 배포 키 나열
배포 키 추가
프로젝트의 배포 키 목록
사용자용 프로젝트 배포 키 목록
단일 배포 키 가져오기
프로젝트에 배포 키 추가
배포 키 업데이트
배포 키 삭제
배포 키 활성화
여러 프로젝트에 배포 키 추가하기

배포 키 API

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

배포 키 API는 응답에 다음 필드들의 공개 키의 지문을 반환할 수 있습니다:

fingerprint (MD5 해시). FIPS 활성화된 시스템에서는 사용할 수 없습니다.
fingerprint_sha256 (SHA256 해시). GitLab 15.2에서 도입되었습니다.

모든 배포 키 나열

Tier: Free, Premium, Ultimate Offering: Self-managed, GitLab Dedicated

GitLab 인스턴스의 모든 프로젝트에서 모든 배포 키의 목록을 가져옵니다. 이 엔드포인트는 관리자 액세스가 필요하며 GitLab.com에서는 사용할 수 없습니다.

GET /deploy_keys

지원되는 속성:

속성	타입	필수	설명
`public`	boolean	No	공개 배포 키만 반환합니다. 기본값은 `false`입니다.

예시 요청:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/deploy_keys?public=true"

예시 응답:

[
  {
    "id": 1,
    "title": "Public key",
    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",
    "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",
    "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",
    "created_at": "2013-10-02T10:12:29Z",
    "expires_at": null,
    "projects_with_write_access": [
      {
        "id": 73,
        "description": null,
        "name": "project2",
        "name_with_namespace": "Sidney Jones / project2",
        "path": "project2",
        "path_with_namespace": "sidney_jones/project2",
        "created_at": "2021-10-25T18:33:17.550Z"
      },
      {
        "id": 74,
        "description": null,
        "name": "project3",
        "name_with_namespace": "Sidney Jones / project3",
        "path": "project3",
        "path_with_namespace": "sidney_jones/project3",
        "created_at": "2021-10-25T18:33:17.666Z"
      }
    ],
    "projects_with_readonly_access": []
  },
  {
    "id": 3,
    "title": "Another Public key",
    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDIJFwIL6YNcCgVBLTHgM6hzmoL5vf0ThDKQMWT3HrwCjUCGPwR63vBwn6+/Gx+kx+VTo9FuojzR0O4XfwD3LrYA+oT3ETbn9U4e/VS4AH/G4SDMzgSLwu0YuPe517FfGWhWGQhjiXphkaQ+6bXPmcASWb0RCO5+pYlGIfxv4eFGQ==",
    "fingerprint": "0b:cf:58:40:b9:23:96:c7:ba:44:df:0e:9e:87:5e:75",
    "fingerprint_sha256": "SHA256:lGI/Ys/Wx7PfMhUO1iuBH92JQKYN+3mhJZvWO4Q5ims",
    "created_at": "2013-10-02T11:12:29Z",
    "expires_at": null,
    "projects_with_write_access": [],
    "projects_with_readonly_access": [
      {
        "id": 74,
        "description": null,
        "name": "project3",
        "name_with_namespace": "Sidney Jones / project3",
        "path": "project3",
        "path_with_namespace": "sidney_jones/project3",
        "created_at": "2021-10-25T18:33:17.666Z"
      }
    ]
  }
]

배포 키 추가

Tier: Free, Premium, Ultimate Offering: Self-managed, GitLab Dedicated

GitLab 17.5에서 도입되었습니다.

GitLab 인스턴스에 배포 키를 생성합니다. 이 엔드포인트는 관리자 액세스가 필요합니다.

POST /deploy_keys

지원되는 속성:

속성	타입	필수	설명
`key`	string	yes	새로운 배포 키
`title`	string	yes	새로운 배포 키의 제목
`expires_at`	datetime	no	배포 키의 만료일. 값이 제공되지 않으면 만료되지 않습니다. ISO 8601 형식(`2024-12-31T08:00:00Z`)으로 제공됩니다.

예시 요청:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --header "Content-Type: application/json" \
     --data '{"title": "My deploy key", "key": "ssh-rsa AAAA...", "expired_at": "2024-12-31T08:00:00Z"}' \
     "https://gitlab.example.com/api/v4/deploy_keys/"

예시 응답:

{
  "id" : 5,
  "title" : "My deploy key",
  "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",
  "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",
  "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",
  "usage_type": "auth_and_signing",
  "created_at": "2024-10-03T01:32:21.992Z",
  "expires_at": "2024-12-31T08:00:00.000Z"
}

프로젝트의 배포 키 목록

프로젝트의 배포 키 목록을 가져옵니다.

GET /projects/:id/deploy_keys

속성	유형	필수	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL-인코딩 된 경로

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/deploy_keys"

응답 예시:

[
  {
    "id": 1,
    "title": "Public key",
    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",
    "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",
    "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",
    "created_at": "2013-10-02T10:12:29Z",
    "expires_at": null,
    "can_push": false
  },
  {
    "id": 3,
    "title": "Another Public key",
    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDIJFwIL6YNcCgVBLTHgM6hzmoL5vf0ThDKQMWT3HrwCjUCGPwR63vBwn6+/Gx+kx+VTo9FuojzR0O4XfwD3LrYA+oT3ETbn9U4e/VS4AH/G4SDMzgSLwu0YuPe517FfGWhWGQhjiXphkaQ+6bXPmcASWb0RCO5+pYlGIfxv4eFGQ=="
    "fingerprint": "0b:cf:58:40:b9:23:96:c7:ba:44:df:0e:9e:87:5e:75",
    "fingerprint_sha256": "SHA256:lGI/Ys/Wx7PfMhUO1iuBH92JQKYN+3mhJZvWO4Q5ims",
    "created_at": "2013-10-02T11:12:29Z",
    "expires_at": null,
    "can_push": false
  }
]

사용자용 프로젝트 배포 키 목록

GitLab 15.1에서 도입.

지정된 사용자(요청받은 사람) 및 인증된 사용자(요청자)의 공통 프로젝트 배포 키 목록을 가져옵니다. 요청자와 요청받은 사람의 공통 프로젝트에서 활성화된 프로젝트 키만 나열됩니다.

GET /users/:id_or_username/project_deploy_keys

매개변수:

속성	유형	필수	설명
`id_or_username`	문자열	예	프로젝트의 배포 키를 가져올 사용자의 ID 또는 사용자 이름.

[
    {
        "id": 1,
        "title": "Key A",
        "created_at": "2022-05-30T12:28:27.855Z",
        "expires_at": null,
        "key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILkYXU2fVeO4/0rDCSsswP5iIX2+B6tv15YT3KObgyDl Key",
        "fingerprint": "40:8e:fa:df:70:f7:a7:06:1e:0d:6f:ae:f2:27:92:01",
        "fingerprint_sha256": "SHA256:Ojq2LZW43BFK/AMP81jBkDGn9YpPWYRNcViKBB44LPU"
    },
    {
        "id": 2,
        "title": "Key B",
        "created_at": "2022-05-30T13:34:56.219Z",
        "expires_at": null,
        "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",
        "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",
        "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",
    }
]

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/users/20/project_deploy_keys"

응답 예시:

[
  {
    "id": 1,
    "title": "Key A",
    "created_at": "2022-05-30T12:28:27.855Z",
    "expires_at": "2022-10-30T12:28:27.855Z",
    "key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILkYXU2fVeO4/0rDCSsswP5iIX2+B6tv15YT3KObgyDl Key",
    "fingerprint": "40:8e:fa:df:70:f7:a7:06:1e:0d:6f:ae:f2:27:92:01",
    "fingerprint_sha256": "SHA256:Ojq2LZW43BFK/AMP81jBkDGn9YpPWYRNcViKBB44LPU"
  }
]

단일 배포 키 가져오기

단일 키 가져오기.

GET /projects/:id/deploy_keys/:key_id

매개변수:

속성	유형	필수	설명
`id`	integer/string	예	프로젝트의 ID 또는 URL 인코딩된 경로
`key_id`	integer	예	배포 키의 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/deploy_keys/11"

응답 예:

{
  "id": 1,
  "title": "Public key",
  "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",
  "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",
  "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",
  "created_at": "2013-10-02T10:12:29Z",
  "expires_at": null,
  "can_push": false
}

프로젝트에 배포 키 추가

프로젝트에 새로운 배포 키를 만듭니다.

이미 다른 프로젝트에 배포 키가 존재하는 경우, 해당 배포 키는 현재 프로젝트에 동일한 사용자에 의해 원래 프로젝트에 액세스할 수 있는 경우에만 현재 프로젝트에 연결됩니다.

POST /projects/:id/deploy_keys

속성	유형	필수	설명
`id`	integer/string	예	프로젝트의 ID 또는 URL 인코딩된 경로
`key`	string	예	새로운 배포 키
`title`	string	예	새로운 배포 키 제목
`can_push`	boolean	아니오	배포 키가 프로젝트 저장소에 푸시할 수 있는지 여부
`expires_at`	datetime	아니오	배포 키의 만료 날짜. 값이 제공되지 않으면 만료되지 않음. ISO 8601 형식으로 예상됨 (`2019-03-15T08:00:00Z`)

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --header "Content-Type: application/json" \
     --data '{"title": "내 배포 키", "key": "ssh-rsa AAAA...", "can_push": "true"}' \
     "https://gitlab.example.com/api/v4/projects/5/deploy_keys/"

응답 예:

{
   "key" : "ssh-rsa AAAA...",
   "id" : 12,
   "title" : "내 배포 키",
   "can_push": true,
   "created_at" : "2015-08-29T12:44:31.550Z",
   "expires_at": null
}

배포 키 업데이트

프로젝트의 배포 키를 업데이트합니다.

PUT /projects/:id/deploy_keys/:key_id

속성	유형	필수	설명
`id`	integer/string	예	프로젝트의 ID 또는 URL 인코딩된 경로
`can_push`	boolean	아니오	배포 키가 프로젝트 저장소에 푸시할 수 있는지 여부
`title`	string	아니오	새로운 배포 키의 제목

curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" --header "Content-Type: application/json" \
     --data '{"title": "새로운 배포 키", "can_push": true}' "https://gitlab.example.com/api/v4/projects/5/deploy_keys/11"

응답 예:

{
   "id": 11,
   "title": "새로운 배포 키",
   "key": "ssh-rsa AAAA...",
   "created_at": "2015-08-29T12:44:31.550Z",
   "expires_at": null,
   "can_push": true
}

배포 키 삭제

프로젝트에서 배포 키를 제거합니다. 배포 키가 해당 프로젝트에서만 사용되는 경우 시스템에서 삭제됩니다.

DELETE /projects/:id/deploy_keys/:key_id

속성	유형	필수	설명
`id`	integer/string	예	프로젝트의 ID 또는 URL 인코딩된 경로
`key_id`	integer	예	배포 키의 ID

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/deploy_keys/13"

배포 키 활성화

프로젝트의 배포 키를 활성화하여 사용할 수 있도록 합니다. 성공하면 활성화된 키와 함께 상태 코드 201이 반환됩니다.

POST /projects/:id/deploy_keys/:key_id/enable

속성	유형	필수	설명
`id`	integer/string	예	프로젝트의 ID 또는 URL 인코딩된 경로
`key_id`	integer	예	배포 키의 ID

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/deploy_keys/12/enable"

응답 예:

{
   "key" : "ssh-rsa AAAA...",
   "id" : 12,
   "title" : "내 배포 키",
   "created_at" : "2015-08-29T12:44:31.550Z",
   "expires_at": null
}

여러 프로젝트에 배포 키 추가하기

동일한 배포 키를 동일한 그룹 내의 여러 프로젝트에 추가하려면 API로 이를 달성할 수 있습니다.

먼저, 관심 있는 프로젝트의 ID를 찾아야 합니다. 이를 위해 모든 프로젝트를 나열하거나:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects"

또는 그룹의 ID를 찾아야 합니다:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups"

그런 다음 해당 그룹의 모든 프로젝트를 나열합니다 (예: 그룹 1234의 경우):

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/1234"

이러한 ID를 사용하여 모든 프로젝트에 동일한 배포 키를 추가합니다:

for project_id in 321 456 987; do
    curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
         --header "Content-Type: application/json" \
         --data '{"title": "my key", "key": "ssh-rsa AAAA..."}' \
         "https://gitlab.example.com/api/v4/projects/${project_id}/deploy_keys"
done

배포 키 API

모든 배포 키 나열

배포 키 추가

프로젝트의 배포 키 목록

사용자용 프로젝트 배포 키 목록

단일 배포 키 가져오기

프로젝트에 배포 키 추가

배포 키 업데이트

배포 키 삭제

배포 키 활성화

여러 프로젝트에 배포 키 추가하기

도움말

기능 사용 가능성과 제품 평가판

도움받기