GitHub 자격 증명
n8n v2.29이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다. 서비스에 대한 자세한 내용은 GitHub API 문서를 참고하세요. 이 자격 증명을 구성하려면 GitHub 계정이 필요합니다. 이 자격 증명을 설정하는 과정은 두 단계로 이루어집니다.
이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다.
- GitHub
- GitHub Trigger
- GitHub Document Loader: 이 노드는 OAuth를 지원하지 않습니다.
사전 요구사항#
GitHub 계정을 생성하세요.
지원되는 인증 방법#
- API 액세스 토큰: 모든 GitHub 노드에서 이 방법을 사용할 수 있습니다.
- OAuth2: 이 방법은 GitHub 및 GitHub Trigger 노드에서만 사용하세요. GitHub Document Loader에는 사용하지 마세요.
관련 자료#
서비스에 대한 자세한 내용은 GitHub API 문서를 참고하세요.
API 액세스 토큰 사용#
이 자격 증명을 구성하려면 GitHub 계정이 필요합니다.
이 자격 증명을 설정하는 과정은 두 단계로 이루어집니다.
자세한 지침은 아래 섹션을 참고하세요.
개인 액세스 토큰 생성#
권장 액세스 토큰 유형
n8n은 개인 액세스 토큰(classic)을 사용하는 것을 권장합니다. GitHub의 세분화된 개인 액세스 토큰(fine-grained personal access token)을 사용하면 특정 리포지터리와 권한으로 액세스를 제한할 수 있지만, 몇 가지 제한 사항이 있습니다.
개인 액세스 토큰을 생성하려면 다음을 수행하세요.
- 아직 하지 않았다면 GitHub에서 이메일 주소를 인증하세요. 자세한 내용은 이메일 주소 인증하기를 참고하세요.
- GitHub 프로필 Settings를 여세요.
- 왼쪽 내비게이션에서 Developer settings를 선택하세요.
- 왼쪽 내비게이션에서 Personal access tokens 아래의 **Tokens (classic)**을 선택하세요.
- **Generate new token > Generate new token (classic)**을 선택하세요.
- Note 필드에
n8n integration과 같이 알아보기 쉬운 이름을 입력하세요. - 토큰의 Expiration을 원하는 대로 선택하거나 No expiration을 선택하세요.
- 토큰의 Scopes를 선택하세요. 대부분의 n8n GitHub 노드에서는
repo스코프를 추가하세요.- 스코프가 지정되지 않은 토큰은 공개 정보에만 액세스할 수 있습니다.
- Generate token을 선택하세요.
- 토큰을 복사하세요.
자세한 내용은 개인 액세스 토큰(classic) 생성하기를 참고하세요. GitHub 스코프에 대한 자세한 내용은 OAuth 앱 스코프를 참고하세요.
자격 증명 설정#
그런 다음, n8n 자격 증명에서 다음을 수행하세요.
- GitHub Enterprise Server를 사용하지 않는다면 GitHub server URL을 변경하지 마세요.
- GitHub Enterprise Server를 사용한다면 GitHub server를 서버의 URL과 일치하도록 업데이트하세요.
- GitHub 프로필에 표시되는 대로 User 이름을 입력하세요.
- 위에서 생성한 Access Token을 입력하세요.
OAuth2 사용#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
n8n을 셀프 호스팅하는 경우 새로운 GitHub OAuth 앱을 생성하세요.
- GitHub 프로필 Settings를 여세요.
- 왼쪽 내비게이션에서 Developer settings를 선택하세요.
- 왼쪽 내비게이션에서 OAuth apps를 선택하세요.
- New OAuth App을 선택하세요.
- 이전에 앱을 만든 적이 없다면 대신 Register a new application이 표시될 수 있습니다. 이를 선택하세요.
n8n integration과 같은 Application name을 입력하세요.- 앱 웹사이트의 Homepage URL을 입력하세요.
- 원한다면 GitHub가 최종 사용자에게 표시하는 선택 항목인 Application description을 추가하세요.
- n8n에서 OAuth Redirect URL을 복사하여 GitHub의 Authorization callback URL에 붙여넣으세요.
- Register application을 선택하세요.
- 여기서 생성된 Client ID와 Client Secret을 복사하여 n8n 자격 증명에 추가하세요.
인증 절차에 대한 자세한 내용은 GitHub OAuth 앱 인가 문서를 참고하세요.