View a markdown version of this page

Smartsheet 통합 - Amazon Quick
사전 조건Smartsheet 개발자 도구 구성OAuth 액세스 범위Amazon Quick에서 통합 설정사용 가능한 작업관리 및 문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Smartsheet 통합

Smartsheet 작업 커넥터를 사용하여 Amazon Quick에서 자연어를 통해 직접 Smartsheet 워크스페이스에서 시트, 행, 보고서 및 검색을 관리할 수 있습니다. 이 통합은 Smartsheet API를 사용합니다. 자세한 내용은 Smartsheet 설명서의 Smartsheet API 소개를 참조하세요.

이 통합을 설정하려면 두 단계가 필요합니다. 먼저 선택한 인증 방법에 대해 Smartsheet에서 자격 증명을 구성합니다. 그런 다음 Amazon Quick에서 통합을 생성하고 Smartsheet 계정에 연결합니다. Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.

사전 조건

통합을 설정하기 전에 다음 요구 사항을 충족하는지 확인합니다.

Smartsheet 개발자 도구 구성

Amazon Quick을 구성하기 전에 Smartsheet에서 자격 증명을 설정합니다. 완료하는 단계는 사용하려는 인증 방법에 따라 다릅니다. Amazon Quick은 Smartsheet에 대해 두 가지 인증 방법을 지원합니다. 이 방법들에 대한 자세한 내용은 인증 방법 섹션을 참조하세요.

Smartsheet OAuth에 대한 자세한 내용은 Smartsheet API 설명서의 OAuth를 참조하세요.

개발자 도구에 등록 및 개발자 프로필 생성

  1. 개발자 도구 등록 페이지로 이동하여 앱에 사용할 Smartsheet 계정을 등록합니다. 자세한 내용은 Smartsheet API 설명서의 개발자 도구 등록을 참조하세요.

  2. Smartsheet가 개발자 도구를 활성화한 후 Smartsheet 애플리케이션에 로그인하고 왼쪽 하단 모서리에서 계정 아이콘을 선택한 다음 개발자 도구를 선택합니다.

  3. 개발자 프로필 생성을 선택하고 프로필 이름을 입력합니다. 자세한 내용은 Smartsheet API 설명서의 개발자 프로필 생성을 참조하세요.

작은 정보

Smartsheet는 개인 계정이 아닌 OAuth 앱 전용 서비스 계정을 사용할 것을 권장합니다.

OAuth 애플리케이션 등록

  1. Smartsheet 개발자 도구에서 새 앱 생성을 선택합니다.

  2. 양식을 작성합니다.

    • 앱 이름 - 사용자에게 앱을 식별하는 이름입니다.

    • 앱 설명 - 통합에 대한 간략한 설명입니다.

    • 앱 URL - 앱을 시작하는 URL 또는 랜딩 페이지입니다.

    • 앱 연락처/지원 - 지원 연락처 정보입니다.

    • 앱 리디렉션 URL - https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

      {region}을 해당 AWS 리전(예: us-east-1)으로 바꿉니다.

  3. 저장을 선택합니다. Smartsheet는 앱 클라이언트 ID와 앱 보안 암호를 생성합니다.

  4. 클라이언트 ID 및 클라이언트 보안 암호 값을 복사합니다. Amazon Quick에서 통합을 구성할 때 필요합니다.

자세한 내용은 Smartsheet API 설명서의 앱 등록을 참조하세요.

API 액세스 토큰 생성(서비스 인증만 해당)

OAuth 대신 서비스 인증을 사용하려는 경우 API 액세스 토큰을 생성합니다. 토큰을 생성하려면 비즈니스 또는 엔터프라이즈 플랜이 있어야 합니다. 자세한 내용은 Smartsheet 도움말 센터에서 API 액세스 토큰 생성을 참조하세요.

  1. Smartsheet 애플리케이션에서 왼쪽 탐색 모음 하단의 계정(프로파일 이미지)을 선택한 다음 개인 설정을 선택합니다.

  2. API 액세스 탭을 선택하고 새 액세스 토큰 생성을 선택합니다.

  3. 토큰의 이름을 지정하고 확인을 선택합니다. 토큰 값을 즉시 복사합니다.이 시간만 표시됩니다.

중요

액세스 토큰을 안전하게 저장합니다. 토큰이 있는 사람은 누구나 토큰 소유자가 액세스할 수 있는 모든 Smartsheet 데이터에 액세스할 수 있습니다. 버전 관리 시스템에 토큰을 커밋하지 마십시오. 토큰 저장 모범 사례는 Smartsheet API 설명서의 인증을 참조하세요.

OAuth 액세스 범위

사용자 인증(OAuth)을 구성하면 통합이 Smartsheet에서 다음 액세스 범위를 요청합니다. 이러한 범위에 따라 인증된 사용자를 대신하여 통합이 수행할 수 있는 작업이 결정됩니다. 대신 서비스 인증(API 키)을 사용하는 경우 통합은 토큰 소유자의 전체 권한을 사용하며 범위는 적용되지 않습니다. 자세한 내용은 Smartsheet API 설명서의 액세스 범위를 참조하세요.

Smartsheet OAuth 액세스 범위
Scope 설명
READ_SHEETS 첨부 파일, 토론 및 셀 데이터를 포함한 모든 시트 데이터를 읽습니다.
WRITE_SHEETS 첨부 파일, 토론 및 셀 데이터를 포함한 시트 데이터를 삽입하고 수정합니다.
참고

액세스 범위는 기존 공유 권한을 재정의하지 않습니다. 예를 들어 WRITE_SHEETS 범위가 있으면 통합이 사용자에게 최종 사용자 수준 액세스 권한만 있는 시트를 업데이트할 수 없습니다. 자세한 내용은 Smartsheet API 설명서의 리소스 액세스 수준을 참조하세요.

Amazon Quick에서 통합 설정

Smartsheet 개발자 도구 구성을 완료한 후 Amazon Quick에서 통합을 생성합니다.

  1. Amazon Quick 콘솔에서 커넥터를 선택합니다.

  2. 팀에 대해 생성 탭을 선택합니다.

  3. Smartsheet를 찾아 선택합니다.

  4. 통합 세부 정보를 입력합니다.

    • 이름 - Smartsheet 통합에 대한 설명 이름입니다.

    • 설명(선택 사항) - 통합의 목적입니다.

  5. 연결 유형을 선택하고 연결 설정을 입력합니다. 이러한 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.

    1. 사용자 인증(OAuth)의 경우 Smartsheet 개발자 도구 앱 등록의 클라이언트 ID 및 클라이언트 보안 암호를 사용합니다. 다음 필드를 구성합니다.

      • 기본 URL - https://api.smartsheet.com/2.0

      • 클라이언트 ID - Smartsheet 개발자 도구 앱 등록의 앱 클라이언트 ID입니다.

      • 클라이언트 보안 암호 - Smartsheet 개발자 도구 앱 등록의 앱 보안 암호입니다.

      • 토큰 URL - https://api.smartsheet.com/2.0/token

      • 인증 URL - https://app.smartsheet.com/b/authorize

      • 리디렉션 URL - https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

    2. 서비스 인증(API 키)의 경우 Smartsheet 개인 설정의 API 액세스 토큰을 사용합니다. 다음 필드를 구성합니다.

      • API 키 - 개인 설정에서 생성된 Smartsheet API 액세스 토큰입니다.

      • 기본 URL - https://api.smartsheet.com/2.0

      • 이메일 - 토큰을 생성한 Smartsheet 계정과 연결된 이메일 주소입니다.

  6. Create and continue를 선택합니다.

  7. 통합을 공유할 사용자를 선택합니다.

  8. 다음을 선택합니다.

사용자 인증의 경우 커넥터 > Smartsheet 커넥터 이름으로 이동하여 로그인을 선택하여 OAuth 권한 부여 흐름을 완료합니다. Smartsheet 동의 창에서 액세스 권한 부여 허용을 선택합니다.

중요

서비스 인증을 사용하면 모든 작업이 API 토큰 소유자의 권한을 사용하여 실행됩니다. 이 통합에 액세스할 수 있는 모든 Amazon Quick 사용자는 토큰 소유자가 액세스할 수 있는 모든 Smartsheet 리소스에 대해 작업을 수행할 수 있습니다. 조직의 보안 요구 사항에 맞게 토큰 권한의 범위를 적절하게 지정합니다.

참고

Smartsheet Gov, Smartsheet Regions Europe 또는 Smartsheet Regions Australia를 사용하는 경우 환경에 해당하는 기본 URL을 사용합니다.

Smartsheet 리전 기본 URLs
환경 기본 URL
Smartsheet https://api.smartsheet.com/2.0
스마트시트 Gov https://api.smartsheetgov.com/2.0
유럽 스마트시트 리전 https://api.smartsheet.eu/2.0
Smartsheet 리전 호주 https://api.smartsheet.au/2.0

자세한 내용은 Smartsheet API 설명서의 기본 URL을 참조하세요.

사용 가능한 작업

통합을 설정한 후 다음 작업을 사용할 수 있습니다.

Smartsheet 사용 가능한 작업
카테고리 작업 설명
검색 목록 검색 사용자가 액세스할 수 있는 모든 시트에서 지정된 텍스트를 검색합니다.
시트 List Sheets 인증된 사용자가 액세스할 수 있는 모든 시트를 나열합니다.
시트 시트 가져오기 시트 ID를 기반으로 시트와 해당 데이터를 가져옵니다.
Reports 보고서 나열 사용자가 액세스할 수 있는 모든 보고서를 나열합니다.
Reports 보고서 보기 보고서 ID를 기반으로 보고서 세부 정보를 가져옵니다.

관리 및 문제 해결

통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.

인증 문제

  • OAuth 권한 부여 실패 - 클라이언트 ID와 클라이언트 보안 암호가 Smartsheet 개발자 도구 앱 등록의 값과 일치하는지 확인합니다. Smartsheet의 리디렉션 URL이 Amazon Quick 구성의 URL과 정확히 일치하는지 확인합니다. OAuth 오류 유형 목록은 Smartsheet API 설명서의 OAuth 오류 유형을 참조하세요.

  • 개발자 도구를 사용할 수 없음 - Smartsheet 계정에 개발자 도구가 활성화되어 있는지 확인합니다. 무료 계정은 개발자 도구를 지원하지 않습니다. 요청이 거부된 경우 Smartsheet 고객 성공 관리자에게 문의하세요.

  • API 키 인증 실패 - 액세스 토큰이 취소되지 않았는지 확인합니다. Smartsheet 애플리케이션의 개인 설정 > API 액세스에서 토큰을 관리할 수 있습니다. 자세한 내용은 Smartsheet 도움말 센터에서 API 액세스 토큰 생성을 참조하세요.

  • 액세스 토큰 만료 - OAuth 액세스 토큰은 약 7일 후에 만료됩니다. Amazon Quick은 토큰 새로 고침을 자동으로 처리합니다. 지속적인 토큰 오류가 발생하면 통합 설정에서 로그아웃하고 다시 로그인합니다. 자세한 내용은 Smartsheet API 설명서의 API 직접 호출을 참조하세요.

일반적인 오류 메시지

  • 작업 반환 권한 오류 - 인증된 사용자에게 대상 시트에 필요한 공유 권한이 있는지 확인합니다. OAuth 범위는 공유 수준 액세스 제어를 재정의하지 않습니다. 자세한 내용은 Smartsheet API 설명서의 리소스 액세스 수준을 참조하세요.

  • 시트 찾을 수 없음 - 시트 ID가 올바르고 인증된 사용자에게 시트에 대한 최종 사용자 액세스 권한이 있는지 확인합니다.

  • API 속도 제한 오류 - Smartsheet API는 속도 제한을 적용합니다. 자세한 내용은 Smartsheet API 설명서의 제한 사항을 참조하세요.