콘텐츠로 이동
📣 인포그랩에서 OpenAI 기술 기반으로 자체 개발한 자동화 번역 프로그램을 통해 n8n 공식 문서의 한글판을 국내 최초로 제공합니다.

Slack 자격 증명#

다음 노드를 인증하기 위해 이 자격 증명을 사용할 수 있습니다:

지원되는 인증 방법#

  • API 액세스 토큰:
    • Slack 트리거 노드에 필요합니다.
    • Slack 노드와 함께 작동하지만 추천하지 않습니다.
  • OAuth2:
    • Slack 노드에 권장되는 방법입니다.
    • Slack 트리거 노드와는 작동하지 않습니다.

관련 자료#

서비스에 대한 추가 정보는 Slack의 API 문서를 참조하세요.

API 액세스 토큰 사용#

이 자격 증명을 구성하려면 Slack 계정과:

  • 액세스 토큰이 필요합니다.

액세스 토큰을 생성하려면 슬랙 앱을 생성하세요:

  1. Slack API Apps 페이지를 엽니다.
  2. 새 앱 만들기 > 처음부터 선택합니다.
  3. 앱 이름을 입력합니다.
  4. 앱을 개발할 워크스페이스를 선택합니다.
  5. 앱 만들기를 선택합니다. 앱 세부 정보가 열립니다.
  6. 왼쪽 메뉴에서 기능 아래 OAuth 및 권한을 선택합니다.
  7. 범위 섹션에서 앱에 적합한 범위를 선택합니다. 추천 범위 목록은 범위를 참조하세요.
  8. 범위를 추가한 후 OAuth 토큰 섹션으로 올라가 워크스페이스에 설치를 선택합니다. 이 작업을 완료하려면 슬랙 워크스페이스 관리자가 되어야 합니다.
  9. 허용을 선택합니다.
  10. 봇 사용자 OAuth 토큰을 복사하여 n8n 자격 증명의 액세스 토큰으로 입력합니다.
  11. Slack 트리거에서 이 자격 증명을 사용하는 경우, 앱 설정을 마치기 위해 Slack 트리거 구성 단계를 따르세요.

추가 정보는 Slack API 빠른 시작을 참조하세요.

Slack 트리거 구성#

Slack 트리거 노드와 함께 Slack 앱을 사용하려면:

  1. 기능 > 이벤트 구독으로 이동합니다.
  2. 이벤트 활성화 컨트롤을 켭니다.
  3. n8n에서 웹후크 URL을 복사하여 Slack 앱의 요청 URL로 입력합니다.

    요청 URL

    Slack은 앱당 하나의 요청 URL만 허용합니다. 워크플로우를 테스트하려면 다음 중 하나를 수행해야 합니다:

    • 먼저 테스트 URL로 테스트한 다음, 모든 것이 작동하는 것을 확인한 후 Slack 앱을 프로덕션 URL로 변경합니다.
    • 실행 로그와 함께 프로덕션 URL을 사용합니다.
  4. 확인되면 구독할 봇 이벤트를 선택합니다. n8n의 트리거 기준 필드를 사용하여 이러한 요청을 필터링합니다.

    • 목록에 없는 이벤트를 사용하려면 그것을 봇 이벤트로 추가하고 n8n 노드에서 모든 이벤트를 선택합니다.

자세한 정보는 빠른 시작 | 이벤트 수신을 위한 앱 구성을 참조하세요.

OAuth2 사용하기#

n8n Cloud 사용자 참고 사항

Cloud 사용자는 연결 정보를 직접 입력할 필요가 없습니다.
Connect my account 를 선택하면 브라우저를 통해 계정을 연결할 수 있습니다.

자체 호스팅 n8n을 하고 있고 OAuth2를 처음부터 구성해야 하는 경우, Slack 계정과 다음이 필요합니다:

  • 클라이언트 ID
  • 클라이언트 비밀

두 가지를 얻으려면 Slack 앱을 생성하세요:

  1. Slack API Apps 페이지를 엽니다.
  2. Create New App > From scratch을 선택합니다.
  3. 앱 이름을 입력합니다.
  4. 앱을 개발할 작업공간을 선택합니다.
  5. Create App을 선택합니다. 앱 세부 정보가 열립니다.
  6. Settings > Basic Information에서 App Credentials 섹션을 엽니다.
  7. 클라이언트 ID클라이언트 비밀을 복사합니다. 이를 n8n의 해당 필드에 붙여넣습니다.
  8. 왼쪽 메뉴에서 Features 아래 OAuth & Permissions를 선택합니다.
  9. Redirect URLs 섹션에서 Add New Redirect URL을 선택합니다.
  10. n8n에서 OAuth Callback URL을 복사하고 Slack의 새로운 Redirect URL로 입력합니다.
  11. Add를 선택합니다.
  12. Save URLs를 선택합니다.
  13. Scopes 섹션에서 앱에 적절한 범위를 선택합니다. 범위 목록은 Scopes를 참조하세요.
  14. 범위를 추가한 후, OAuth Tokens 섹션으로 올라가 Install to Workspace를 선택합니다. 이 작업을 완료하려면 Slack 작업공간 관리자여야 합니다.
  15. Allow를 선택합니다.
  16. 이 시점에서 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 앱을 생성해야 합니다.

인포레터에서 최신 DevOps 트렌드를 격주로 만나보세요!