Slack 자격 증명#
다음 노드를 인증하기 위해 이 자격 증명을 사용할 수 있습니다:
지원되는 인증 방법#
- API 액세스 토큰:
- OAuth2:
관련 자료#
서비스에 대한 추가 정보는 Slack의 API 문서를 참조하세요.
API 액세스 토큰 사용#
이 자격 증명을 구성하려면 Slack 계정과:
- 액세스 토큰이 필요합니다.
액세스 토큰을 생성하려면 슬랙 앱을 생성하세요:
- Slack API Apps 페이지를 엽니다.
- 새 앱 만들기 > 처음부터 선택합니다.
- 앱 이름을 입력합니다.
- 앱을 개발할 워크스페이스를 선택합니다.
- 앱 만들기를 선택합니다. 앱 세부 정보가 열립니다.
- 왼쪽 메뉴에서 기능 아래 OAuth 및 권한을 선택합니다.
- 범위 섹션에서 앱에 적합한 범위를 선택합니다. 추천 범위 목록은 범위를 참조하세요.
- 범위를 추가한 후 OAuth 토큰 섹션으로 올라가 워크스페이스에 설치를 선택합니다. 이 작업을 완료하려면 슬랙 워크스페이스 관리자가 되어야 합니다.
- 허용을 선택합니다.
- 봇 사용자 OAuth 토큰을 복사하여 n8n 자격 증명의 액세스 토큰으로 입력합니다.
- Slack 트리거에서 이 자격 증명을 사용하는 경우, 앱 설정을 마치기 위해 Slack 트리거 구성 단계를 따르세요.
추가 정보는 Slack API 빠른 시작을 참조하세요.
Slack 트리거 구성#
Slack 트리거 노드와 함께 Slack 앱을 사용하려면:
- 기능 > 이벤트 구독으로 이동합니다.
- 이벤트 활성화 컨트롤을 켭니다.
-
n8n에서 웹후크 URL을 복사하여 Slack 앱의 요청 URL로 입력합니다.
요청 URL
Slack은 앱당 하나의 요청 URL만 허용합니다. 워크플로우를 테스트하려면 다음 중 하나를 수행해야 합니다:
- 먼저 테스트 URL로 테스트한 다음, 모든 것이 작동하는 것을 확인한 후 Slack 앱을 프로덕션 URL로 변경합니다.
- 실행 로그와 함께 프로덕션 URL을 사용합니다.
-
확인되면 구독할 봇 이벤트를 선택합니다. n8n의 트리거 기준 필드를 사용하여 이러한 요청을 필터링합니다.
- 목록에 없는 이벤트를 사용하려면 그것을 봇 이벤트로 추가하고 n8n 노드에서 모든 이벤트를 선택합니다.
자세한 정보는 빠른 시작 | 이벤트 수신을 위한 앱 구성을 참조하세요.
OAuth2 사용하기#
n8n Cloud 사용자 참고 사항
Cloud 사용자는 연결 정보를 직접 입력할 필요가 없습니다.
Connect my account 를 선택하면 브라우저를 통해 계정을 연결할 수 있습니다.
자체 호스팅 n8n을 하고 있고 OAuth2를 처음부터 구성해야 하는 경우, Slack 계정과 다음이 필요합니다:
- 클라이언트 ID
- 클라이언트 비밀
두 가지를 얻으려면 Slack 앱을 생성하세요:
- Slack API Apps 페이지를 엽니다.
- Create New App > From scratch을 선택합니다.
- 앱 이름을 입력합니다.
- 앱을 개발할 작업공간을 선택합니다.
- Create App을 선택합니다. 앱 세부 정보가 열립니다.
- Settings > Basic Information에서 App Credentials 섹션을 엽니다.
- 클라이언트 ID와 클라이언트 비밀을 복사합니다. 이를 n8n의 해당 필드에 붙여넣습니다.
- 왼쪽 메뉴에서 Features 아래 OAuth & Permissions를 선택합니다.
- Redirect URLs 섹션에서 Add New Redirect URL을 선택합니다.
- n8n에서 OAuth Callback URL을 복사하고 Slack의 새로운 Redirect URL로 입력합니다.
- Add를 선택합니다.
- Save URLs를 선택합니다.
- Scopes 섹션에서 앱에 적절한 범위를 선택합니다. 범위 목록은 Scopes를 참조하세요.
- 범위를 추가한 후, OAuth Tokens 섹션으로 올라가 Install to Workspace를 선택합니다. 이 작업을 완료하려면 Slack 작업공간 관리자여야 합니다.
- Allow를 선택합니다.
- 이 시점에서 n8n 자격 증명에서 OAuth 버튼을 선택하여 연결할 수 있어야 합니다.
추가 정보를 위해 Slack API Quickstart를 참조하세요. OAuth 흐름에 대한 자세한 내용은 Slack Installing with OAuth 문서를 참조하세요.
범위#
범위는 앱이 가질 수 있는 권한을 결정합니다.
- 앱이 앱을 승인한 사용자를 대신하여 작동하기를 원한다면 User Token Scopes 섹션에 필요한 범위를 추가하십시오.
- 봇을 구축 중이라면 Bot Token Scopes 섹션에 필요한 범위를 추가하십시오.
OAuth 자격 증명에 필요한 범위 목록은 다음과 같으며, 이는 좋은 출발점입니다:
범위 이름 | 비고 |
---|---|
channels:read |
|
channels:write |
봇 토큰 범위로는 사용 불가 |
chat:write |
|
files:read |
|
files:write |
|
groups:read |
|
im:read |
|
mpim:read |
|
reactions:read |
|
reactions:write |
|
stars:read |
봇 토큰 범위로는 사용 불가 |
stars:write |
봇 토큰 범위로는 사용 불가 |
usergroups:read |
|
usergroups:write |
|
users.profile:read |
|
users.profile:write |
봇 토큰 범위로는 사용 불가 |
users:read |
일반적인 문제#
토큰 만료#
Slack에서는 토큰 회전(Token Rotation) 기능을 제공하며,
이 기능을 활성화하면 봇 및 사용자 토큰이 12시간마다 만료됩니다.
테스트 환경에서는 유용할 수 있지만,
이 기능이 활성화된 토큰을 사용하는 n8n 자격 증명은 만료 후 작동하지 않습니다.
Slack 자격 증명을 프로덕션 환경에서 사용하려면, 토큰 회전 기능을 비활성화해야 합니다.
토큰 회전이 활성화되어 있는지 확인하려면
Slack API 문서 | Token Rotation{:target=_blank .external-link)를 참고하세요.
앱에서 토큰 회전을 사용하는 경우
한 번 활성화된 토큰 회전 기능은 다시 비활성화할 수 없습니다.
토큰 회전을 비활성화한 새로운 Slack 앱을 생성해야 합니다.