장기 토큰 없이 배포할 수 있도록 Zinn® GitHub 앱을 설치해 주세요

연결 시 제공되는 기능

Zinn® GitHub 앱을 설치하면 개인 토큰을 당사에 전달하지 않고도 사이트가 저장소에서 배포되도록 하고 프로젝트 보드가 GitHub와 동기화된 상태를 유지하도록 할 수 있습니다. 당사는 단독으로는 사용할 수 없는 앱의 설치 번호만 보유하며, 토큰이 필요할 때마다 1시간 동안 유효한 토큰을 새로 발급합니다. 이는 특정 개인에게 귀속되지 않으며 누군가가 퇴사하더라도 작동이 중단되지 않으므로 조직에 더 적합한 선택입니다.

시작하기 전에

GitHub 계정 또는 앱을 설치하려는 조직의 소유자 권한이 필요합니다. 타사 앱을 금지하는 조직의 경우 소유자가 이를 허용해야 합니다. 허용이 불가능하다면 대신 세분화된 토큰을 사용하십시오(GitHub 계정 연결).

1. GitHub에서 키 생성하기

생성할 키는 없습니다. 개인 계정 또는 조직에 Zinn® GitHub 앱을 설치하고, 모든 저장소를 선택하거나 당사가 배포하기를 원하는 저장소만 선택하십시오.

그런 다음 설치 번호를 찾으십시오:

• 개인 계정 — Settings → Applications → Installed GitHub Apps로 이동한 뒤 Zinn® 앱 옆의 Configure를 클릭합니다.
• 조직 — Your organizations → Settings → GitHub Apps로 이동한 뒤 Zinn® 앱 옆의 Configure를 클릭합니다.

해당 페이지의 주소 표시줄 끝에 있는 번호(예: github.com/settings/installations/12345678)가 설치 번호입니다.

2. 여기서 연결하기

앱은 연동(Integrations) 화면 대신 앱이 사용되는 위치에서 선택합니다:

• 사이트의 저장소 연결 시, GitHub (app install)을 선택하십시오.
• 프로젝트 보드의 GitHub 링크 시, The Zinn® GitHub app을 선택하십시오.

설치 번호를 붙여넣고 계속 진행하십시오. 당사는 어떤 항목도 저장하기 전에 설치 상태를 확인하므로, 연결할 수 없는 번호는 절대 저장되지 않습니다.

이후 진행 과정

• 앱에 접근 권한을 부여한 저장소들이 사이트 배포 소스로 나타나며, 푸시(push) 시 배포가 진행됩니다.
• 당사가 수행하는 모든 작업은 귀하의 이름이 아닌 해당 앱의 이름으로 GitHub의 설치 감사 로그(audit log)에 표시됩니다.
• 더 많은 저장소 접근 권한을 부여하려면 동일한 Configure 페이지에서 앱의 저장소 접근 권한을 변경하십시오. 아무것도 다시 연결할 필요가 없습니다.

연결되지 않는 경우

저장소가 누락되었습니다. 설치는 귀하가 선택한 저장소에만 적용됩니다. Configure를 열고 해당 저장소를 추가하십시오.

번호가 거부되었습니다. 앱 자체의 ID가 아닌 주소 표시줄의 설치 번호인지, 그리고 앱이 여전히 설치되어 있는지 확인하십시오. 설치가 취소된 앱에는 설치 정보가 존재하지 않습니다.

키가 거부되었다는 메시지가 표시됩니다. 거의 항상 공백이나 줄 바꿈이 함께 복사되었거나, 키가 만료되었거나, 복사한 후 키가 취소 또는 재생성된 세 가지 경우 중 하나입니다. 새 키를 생성하여 다시 붙여넣으십시오.

연결은 되지만 이후 단계에서 실패합니다. 키 인증은 되었으나 작업에 필요한 권한이 부족합니다. 위에 안내된 권한으로 새 키를 생성한 후, 기존 연결을 해제하고 새 키를 연결하십시오.

연결 해제하기

Integrations를 열고 계정을 찾은 뒤 Disconnect를 누르십시오. 그러면 저장된 키가 즉시 삭제됩니다. 해당 키를 사용하던 모든 작업은 다음 작업 실행 시 중단되며, 해당 키에 의존하던 화면에는 오류가 조용히 무시되는 대신 안내 메시지가 표시됩니다.

연결을 해제해도 이미 수행된 작업(당사가 귀하의 계정에서 변경한 기록, 배포 또는 설정)은 취소되지 않으며 그대로 유지됩니다. 키 자체가 유출되었다고 생각되면 제공업체에서도 해당 키를 해지하십시오. 연결 해제 시 당사 측 사본만 제거되며 제공업체 측 사본은 제거되지 않습니다.