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

• Grist

사전 준비 사항#

Grist 계정을 생성하세요.

지원되는 인증 방법#

• API 키
• OAuth2

관련 리소스#

서비스에 대한 자세한 내용은 Grist API 문서를 참조하세요.

API 키 사용하기#

이 자격 증명을 구성하려면 다음이 필요합니다:

• API Key: Grist에서 계정 메뉴(오른쪽 상단)를 열고 Account settings > Developer로 이동하여 API 키를 생성하거나 복사하세요. 자세한 내용은 Grist API 인증 문서를 참조하세요.
• Grist URL: n8n이 접속할 Grist 서버를 지정합니다.
  • 기본값 https://api.getgrist.com은 호스팅된 Grist(getgrist.com)의 모든 계정에서 작동합니다.
  • 특정 팀으로 연결을 제한하려면 https://YOUR_TEAM.getgrist.com을 사용하세요.
  • 자체 관리형 인스턴스의 경우 해당 URL을 사용하세요(예: https://grist.example.com).

OAuth2 사용하기#

자체 관리형 Grist에서 OAuth 앱은 Grist 풀 에디션에 포함되어 있습니다. 인스턴스에서 OAuth 앱을 제공하지 않는 경우 API 키를 사용하세요.

이 자격 증명을 구성하려면 다음이 필요합니다:

• Client ID: OAuth 앱을 등록할 때 Grist가 제공합니다.
• Client Secret: OAuth 앱을 등록할 때 Grist가 제공합니다.
• Grist URL: n8n이 접속할 Grist 서버를 지정합니다.
  • 기본값 https://api.getgrist.com은 호스팅된 Grist(getgrist.com)의 모든 계정에서 작동합니다.
  • 특정 팀으로 연결을 제한하려면 https://YOUR_TEAM.getgrist.com을 사용하세요.
  • 자체 관리형 인스턴스의 경우 해당 URL을 사용하세요(예: https://grist.example.com).

앱을 등록하고 연결하려면:

1. n8n에서 Grist OAuth2 API 자격 증명 생성을 시작하고 OAuth Redirect URL을 복사합니다.
2. Grist에서 계정 메뉴(오른쪽 상단)를 열고 Account settings > Developer로 이동합니다.
3. OAuth apps 섹션에서 Register app을 선택합니다. Application name을 입력하고(예: n8n) n8n 리디렉션 URL을 Redirect URI에 붙여넣습니다.
4. 다음 스코프를 선택합니다: offline_access, doc:read, doc:write
5. Register를 선택한 다음 Client ID와 Client Secret을 복사합니다. Grist는 시크릿을 한 번만 표시합니다.
6. n8n으로 돌아가 Client ID와 Client Secret을 입력한 다음 Connect my account를 선택합니다.
7. Grist의 인증 화면에서 자격 증명이 접근할 수 있는 대상을 선택합니다. **All documents (now and in the future)**를 선택하거나, Selected resources를 선택하여 개별 문서, 워크스페이스 또는 사이트를 지정합니다. 그런 다음 Authorize를 선택합니다.

7단계의 선택은 스코프보다 자격 증명의 범위를 더 좁힙니다. Grist는 모든 호출에서 이를 적용합니다. 부여받지 않은 문서에 대한 요청은 사용자가 직접 그 문서를 열 수 있더라도 실패합니다. 자격 증명을 단일 문서로 지정하면 워크플로가 필요한 데이터에만 접근하도록 제한하기에 좋습니다. 나중에 선택을 변경하거나 자격 증명의 접근 권한만 따로 취소하려면 Grist에서 Account settings > Authorized apps로 이동합니다.

권한 부여가 작동하는 방식과 관리 방법은 Grist 연결된 앱 문서를, 앱 등록에 대한 자세한 내용은 Grist OAuth 앱 문서를 참조하세요.

사용자 지정 스코프 설정#

Grist OAuth2 자격 증명은 기본적으로 다음 스코프를 사용합니다:

• offline_access
• doc:read
• doc:write

자격 증명에 다른 스코프를 선택하려면 Custom Scopes 슬라이더를 활성화하고 Enabled Scopes 목록을 편집합니다. 스코프를 더 제한하면 일부 기능이 예상대로 작동하지 않을 수 있습니다. 예를 들어 doc:write가 없는 자격 증명은 레코드를 읽을 수 있지만 생성, 업데이트 또는 삭제할 수 없습니다. 사용 가능한 전체 스코프 목록은 Grist OAuth 스코프를 참조하세요.