Slack 자격 증명
다음 노드의 인증에 이 자격 증명을 사용할 수 있습니다: 서비스에 대한 자세한 정보는 Slack API 문서를 참조하세요. 이 자격 증명을 구성하려면 Slack 계정과 다음이 필요합니다: 액세스 토큰을 생성하려면 Slack 앱을 생성합니다:
다음 노드의 인증에 이 자격 증명을 사용할 수 있습니다:
지원되는 인증 방법#
- API 액세스 토큰:
- Slack Trigger 노드에 필요합니다.
- Slack 노드에서 작동하지만 권장하지 않습니다.
- OAuth2:
- Slack 노드에 권장하는 방법입니다.
- Slack Trigger 노드에서는 작동하지 않습니다.
관련 리소스#
서비스에 대한 자세한 정보는 Slack API 문서를 참조하세요.
API 액세스 토큰 사용#
이 자격 증명을 구성하려면 Slack 계정과 다음이 필요합니다:
- 액세스 토큰
액세스 토큰을 생성하려면 Slack 앱을 생성합니다:
- Slack API 앱 페이지를 엽니다.
- 새 앱 만들기 > 처음부터를 선택합니다.
- 앱 이름을 입력합니다.
- 앱을 개발할 워크스페이스를 선택합니다.
- 앱 만들기를 선택합니다. 앱 세부 정보가 열립니다.
- 기능 아래 왼쪽 메뉴에서 OAuth 및 권한을 선택합니다.
- 범위 섹션에서 앱에 적합한 범위를 선택합니다. 권장 범위 목록은 범위를 참조하세요.
- 범위를 추가한 후 OAuth 토큰 섹션으로 이동하여 워크스페이스에 설치를 선택합니다. 이 작업을 완료하려면 Slack 워크스페이스 관리자여야 합니다.
- 허용을 선택합니다.
- 봇 사용자 OAuth 토큰을 복사하여 n8n 자격 증명의 액세스 토큰으로 입력합니다.
- 이 자격 증명을 Slack Trigger에 사용하는 경우 Slack Trigger 구성 단계를 따라 앱 설정을 완료합니다.
자세한 내용은 Slack API 빠른 시작을 참조하세요.
Slack Trigger 구성#
Slack Trigger 노드에서 Slack 앱을 사용하려면:
- Slack의 내 앱으로 이동하여 사용할 앱을 선택합니다.
- 기능 > 이벤트 구독으로 이동합니다.
- 이벤트 활성화 제어를 켭니다.
- n8n에서 웹훅 URL을 복사하여 Slack 앱의 요청 URL로 입력합니다.
Slack은 앱당 하나의 요청 URL만 허용합니다. 워크플로를 테스트하려면 다음 중 하나를 수행해야 합니다:
- 먼저 **테스트 URL**로 테스트한 다음 모든 것이 작동하는 것을 확인한 후 **프로덕션 URL**을 사용하도록 Slack 앱을 변경합니다.
- 실행 로깅과 함께 **프로덕션 URL**을 사용합니다.
- 확인 후 구독할 봇 이벤트를 선택합니다. n8n의 트리거 대상 필드를 사용하여 이러한 요청을 필터링합니다.
- 목록에 없는 이벤트를 사용하려면 봇 이벤트로 추가하고 n8n 노드에서 모든 이벤트를 선택합니다.
자세한 내용은 빠른 시작 | 이벤트 수신을 위한 앱 구성을 참조하세요.
n8n은 추가 보안을 위해 Slack Trigger에 대한 요청 서명 검증을 활성화하도록 권장합니다:
- Slack의 내 앱으로 이동하여 사용할 앱을 선택합니다.
- 설정 > 기본 정보로 이동합니다.
- 서명 값을 복사합니다.
- n8n에서 이 값을 자격 증명의 서명 시크릿 필드에 붙여넣습니다.
OAuth2 사용#
Cloud 사용자는 연결 정보를 제공할 필요가 없습니다. **내 계정 연결(Connect my account)**을 선택하여 브라우저를 통해 연결하세요.
n8n을 셀프 호스팅하고 처음부터 OAuth2를 구성해야 하는 경우 Slack 계정과 다음이 필요합니다:
- 클라이언트 ID
- 클라이언트 시크릿
두 항목을 모두 얻으려면 Slack 앱을 생성합니다:
- Slack API 앱 페이지를 엽니다.
- 새 앱 만들기 > 처음부터를 선택합니다.
- 앱 이름을 입력합니다.
- 앱을 개발할 워크스페이스를 선택합니다.
- 앱 만들기를 선택합니다. 앱 세부 정보가 열립니다.
- 설정 > 기본 정보에서 앱 자격 증명 섹션을 엽니다.
- 클라이언트 ID와 클라이언트 시크릿을 복사합니다. 이것을 n8n의 해당 필드에 붙여넣습니다.
- 기능 아래 왼쪽 메뉴에서 OAuth 및 권한을 선택합니다.
- 리디렉션 URL 섹션에서 새 리디렉션 URL 추가를 선택합니다.
- n8n에서 OAuth 콜백 URL을 복사하여 Slack의 새 리디렉션 URL로 입력합니다.
- 추가를 선택합니다.
- URL 저장을 선택합니다.
- 범위 섹션에서 앱에 적합한 범위를 선택합니다. 범위 목록은 범위를 참조하세요.
- 범위를 추가한 후 OAuth 토큰 섹션으로 이동하여 워크스페이스에 설치를 선택합니다. 이 작업을 완료하려면 Slack 워크스페이스 관리자여야 합니다.
- 허용을 선택합니다.
- 이 시점에서 n8n 자격 증명의 OAuth 버튼을 선택하여 연결할 수 있어야 합니다.
자세한 내용은 Slack API 빠른 시작을 참조하세요. OAuth 흐름 자체에 대한 자세한 내용은 Slack OAuth로 설치 문서를 참조하세요.
범위#
범위는 앱이 가진 권한을 결정합니다.
- 앱을 승인하는 사용자를 대신하여 앱이 작동하도록 하려면 사용자 토큰 범위 섹션에서 필요한 범위를 추가합니다.
- 봇을 빌드하는 경우 봇 토큰 범위 섹션에서 필요한 범위를 추가합니다.
OAuth 자격 증명에 필요한 범위 목록으로 좋은 출발점입니다:
| 범위 이름 | 참고 |
|---|---|
channels:read |
|
channels:write |
봇 토큰 범위로 사용 불가 |
channels:history |
|
chat:write |
|
files:read |
|
files:write |
|
groups:read |
|
groups:history |
|
im:read |
|
im:history |
|
mpim:read |
|
mpim:history |
|
reactions:read |
|
reactions:write |
|
stars:read |
봇 토큰 범위로 사용 불가 |
stars:write |
봇 토큰 범위로 사용 불가 |
usergroups:read |
|
usergroups:write |
|
users.profile:read |
|
users.profile:write |
봇 토큰 범위로 사용 불가 |
users:read |
|
search:read |
일반적인 문제#
토큰 만료#
Slack은 봇 및 사용자 토큰에 활성화할 수 있는 토큰 순환 기능을 제공합니다. 이 기능을 활성화하면 모든 토큰이 12시간 후에 만료됩니다. 테스트 목적으로는 유용할 수 있지만, 이 기능이 활성화된 토큰을 사용하는 n8n 자격증명은 만료 후 실패하게 됩니다. Slack 자격증명을 프로덕션에서 사용하려면 이 기능이 꺼져 있어야 합니다.
Slack 앱에 토큰 순환이 활성화되어 있는지 확인하려면 Slack API 문서 | 토큰 순환을 참고하세요.
Slack 앱에서 토큰 순환을 사용하는 경우 다시 비활성화할 수 없습니다. 대신 토큰 순환이 비활성화된 새 Slack 앱을 생성해야 합니다.
