Google Chat에서 GitHub 앱 사용하기

Chat에서 GitHub 앱을 사용하여 문제, pull 요청, 댓글과 같은 GitHub 이벤트에 관한 알림을 받을 수 있습니다.

시작하기 전에

Chat에서 GitHub 앱을 사용하려면 다음 안내를 따르세요.

• Google Workspace 관리자로부터 앱을 설치할 권한을 부여받아야 합니다.
• Chat에 앱을 추가합니다. 앱을 찾아 Chat에 추가하는 방법을 알아보세요.
• GitHub 계정이 필요합니다.
• GitHub 저장소용 Google Chat 앱을 설치해야 합니다.

GitHub 앱 및 OAuth 앱 인증 메커니즘 이해하기

여기에서는 서드 파티 서비스가 GitHub 리소스와 통합하고 액세스하는 기본 메커니즘 역할을 하는 GitHub 앱과 OAuth 앱의 고유한 특성과 운영 모델을 설명합니다. 이러한 차이점을 포괄적으로 이해하는 것은 조직 내에서 최적의 보안 상태를 유지하는 데 매우 중요합니다.

1. 비교 분석: 주요 차이점

두 모델 간의 근본적인 차이는 액세스에 사용되는 ID (보안 주체)와 리소스 승인을 관리하는 메커니즘에 있습니다.

속성	GitHub 앱 (권장 로그인)	OAuth 앱 (기존 로그인)
보안 주체 ID	사용 사례에 따라 사용자로부터 독립된 애플리케이션 ID로 작동하거나 승인 사용자를 대신하여 작동합니다.	승인 사용자를 대신하여 권한을 상속받습니다.
승인 모델	세분화된 권한 (권장): 최소 권한의 원칙을 활용하여 특정 저장소 및 리소스 유형에 대한 액세스를 허용합니다. 예: 메타데이터에 대해서만 읽기 액세스 권한을 부여합니다.	광범위한 범위: 승인 사용자에게 표시되는 모든 리소스에 대한 액세스 권한을 부여하는 등 광범위한 범위로 액세스가 정의됩니다.
사용자 인증 정보 수명	수명이 짧은 토큰: 액세스 토큰의 수명은 제한되어 있으며 (일반적으로 1시간) 자주 갱신해야 하므로 유출 시 위험을 크게 완화합니다.	수명이 긴 토큰: 액세스 토큰은 사용자가 수동으로 취소할 때까지 지속되므로 노출 위험이 장기화됩니다.
설치 요구사항	관리자 또는 조직 소유자가 설치해야 하며, 계정 또는 조직에 대한 공식 링크를 설정하고 앱이 사용자를 대신하여 작동하는 사용 사례에 대해 사용자가 승인해야 합니다.	개별 사용자가 승인해야 하며 액세스가 해당 사용자의 ID에 직접 연결되어야 합니다.

자세한 내용은 GitHub 앱과 OAuth 앱의 차이점을 참고하세요.

2. 권장사항

보안 권장사항에 따라 모든 서드 파티 및 조직 통합에 GitHub 앱 인증 메커니즘을 사용하는 것이 좋습니다. 이 모델은 최소 권한의 원칙을 적용하고 강력한 시간 제한 사용자 인증 정보를 사용하여 OAuth 앱의 위임된 권한 모델에 비해 더 높은 수준의 보안과 운영 안정성을 유지합니다.

GitHub 저장소용 Google Chat 앱을 설치합니다.

Chat에서 GitHub 앱 설정하기

1. Chat을 엽니다.
2. 앱과의 채팅 메시지를 열거나 앱이 있는 스페이스로 이동합니다.
3. 구성 창을 열려면 로그인을 클릭합니다.
4. 액세스 구성 GitHub에 로그인을 클릭합니다.
5. 로그인 절차를 완료한 후 팝업을 닫습니다.
6. 채팅 대화상자를 업데이트하려면 새로고침을 클릭합니다.
7. 저장소 추가에서 알림을 받을 GitHub 저장소를 입력합니다.
8. 알림을 받을 이벤트의 체크박스를 선택합니다.
9. 저장을 클릭합니다.

도움말: 앱을 추가하는 각 스페이스에서 알림을 설정해야 합니다. 앱은 자신이 속한 모든 스페이스에 알림을 전송합니다.

OAuth 앱(기존)에서 GitHub 앱(권장)으로 이전

현재 연결을 이전 OAuth 앱 인증 방법에서 권장되는 GitHub 앱 방법으로 이전하려면 다음 단계를 따르세요.

1. Chat을 엽니다.
2. GitHub 앱과의 채팅 메시지 또는 스페이스를 엽니다.
3. 메시지 입력란에서 Google Workspace 도구 를 클릭합니다.
4. 명령어 목록에서 GitHub 재인증을 선택합니다.
5. 이전 및 재인증 절차를 완료하려면 채팅 대화상자의 화면에 표시된 안내를 따르세요.

스페이스에서 GitHub 앱 사용하기

스페이스에서 앱을 사용하려면 각 메시지 및 앱의 메시지에 대한 답장에서 앱을 @멘션하거나 /멘션해야 합니다.

@멘션 또는 /멘션을 사용하면 스페이스 내 다른 사용자가 아닌 앱에 메시지를 보내고 있음을 확인할 수 있습니다.

1. Chat 앱 을 엽니다.
2. 스페이스에서 @github 또는 /github를 입력한 후 명령어를 입력합니다.
   • @github 또는 /github를 멘션하면 스페이스의 다른 사용자가 아닌 앱으로 메시지가 전송됩니다.

앱 설정 변경하기

스페이스에서 앱을 추가한 사용자만 설정을 변경할 수 있습니다.

1. Chat을 엽니다.
2. 앱과의 채팅 메시지를 열거나 앱이 있는 스페이스로 이동합니다.
3. 앱의 현재 설정을 열려면 /github_settings를 입력합니다.
4. 필요에 따라 설정을 변경합니다.
5. 저장을 클릭합니다.

스페이스에서 앱을 삭제하면 앱 설정도 삭제됩니다.

Chat에서 GitHub 앱의 명령어 알아보기

Chat에서 GitHub 앱이 포함된 채팅 메시지 또는 스페이스의 메시지 입력란에서 다음을 사용할 수 있습니다.

• 슬래시 명령어
  • /github_settings: 설정 대화상자를 엽니다.
  • /github_reminders: 개인 또는 팀의 미완료 pull 요청의 경우 예약된 리마인더를 설정하고 수정합니다.
  • /github_subscribe: GitHub <repoURL> 또는 <owner/repo>를 구독합니다.
  • /github_openIssue: 새 GitHub 문제를 엽니다.
  • /github_logout: GitHub 계정에서 로그아웃합니다.
  • /github_help: 도움말 메시지를 표시합니다.
  • /github_feedback: GitHub 앱에 관한 의견을 보냅니다.
• 빠른 명령어: 빠른 명령어에 액세스하려면 Google Workspace 도구 를 클릭합니다.
  • GitHub Connect: '로그인' 및 '기존 로그인' 옵션이 포함된 메시지가 표시됩니다.
  • GitHub 재인증: 새 연결 방법으로 이전할 수 있습니다.

지원되는 명령어의 전체 목록을 확인하려면 다음 안내를 따르세요.

1. 컴퓨터에서 Chat을 엽니다.
2. 채팅 메시지를 열거나 GitHub 앱이 설치된 스페이스로 이동합니다.
3. /github_help를 입력합니다.

Chat에서 GitHub 앱 문제 해결하기

실시간 알림을 구독할 때 오류가 발생하는 경우

GitHub 앱

스페이스에서 실시간 알림을 설정하려면 다음 단계를 따르세요.

1. 브라우저에서 GitHub 프로필 설정으로 이동합니다.
2. '통합'에서 애플리케이션 승인된 GitHub 앱을 클릭합니다.
   • Google Chat에서 GitHub 앱을 연결하면 승인된 앱 목록에 'Google Chat'이 표시됩니다.
3. GitHub 저장소용 Google Chat 앱을 설치합니다.
   • 또는 조직/저장소 소유자에게 설치를 요청할 수 있습니다.
4. 설치가 완료될 때까지 기다립니다.
5. Google Chat에서 GitHub 앱이 있는 채팅 메시지 또는 스페이스를 엽니다.
6. 메시지 필드에서 구독을 만들려면 /github_subscribe [organisation/repo] 또는 /github_settings를 입력합니다.

OAuth 앱

스페이스에서 실시간 알림을 설정하려면 다음 조건을 충족해야 합니다.

• 제안된 저장소의 조직 소유자여야 합니다.
• GitHub 조직에서 앱을 승인합니다.
  1. 브라우저에서 GitHub 프로필 설정으로 이동합니다.
  2. '통합'에서 애플리케이션 승인된 OAuth 앱을 클릭합니다.
     • Google Chat에서 GitHub 앱을 연결하면 승인된 앱 목록에 'Google Chat'이 표시됩니다.
  3. 액세스하려는 조직에 앱 액세스 권한을 부여합니다.

GitHub 앱에서 보낸 알림이 너무 많이 수신되는 경우

1. 메시지 필드에 /github_settings를 입력합니다.
2. 저장소 알림 설정을 수정하려면 알림 설정을 클릭합니다.
3. 알림을 필터링하려면 각 알림 유형 옆에 있는 아래쪽 화살표 를 클릭합니다.
   • 알림을 필터링하기 위한 추가 옵션이 표시됩니다.
4. 원하는 알림의 체크박스를 선택합니다.
5. 저장을 클릭합니다.

예약된 리마인더에서 @멘션되지 않는 경우

예약된 리마인더에서 멘션을 받으려면 Google Chat 계정을 GitHub 계정에 연결해야 합니다.

1. 메시지 필드에 /github_settings를 입력합니다.
2. 계정을 연결하려면 다음 안내를 따르세요.
   1. 팝업에서 액세스 구성 GitHub에 로그인을 클릭합니다.
   2. GitHub 계정에 로그인합니다.
   3. 앱을 승인합니다.
3. GitHub 앱에서 받은 메시지에서 팀의 리마인더 예약을 선택합니다.
4. 팝업에서
   1. 새 리마인더 만들기를 클릭합니다.
   2. 리마인더 설정을 구성합니다.
   3. 저장을 클릭합니다.

GitHub 앱에서 리마인더를 받지 못하는 경우

리마인더를 받을 저장소에서 GitHub용 Google Chat 앱 설치를 확인합니다.

_{Google, Google Workspace 및 관련 마크와 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표입니다.}