이 가이드는 기본 제공 OAuth 또는 조직의 OAuth 클라이언트를 사용해 Databricks Genie 커넥터를 설정하는 ChatGPT 워크스페이스 관리자와 ChatGPT Plus 또는 Pro 사용자를 위한 안내입니다.
기본 제공 OAuth: ChatGPT에서 사용할 수 있고 Databricks 워크스페이스에 활성화되어 있다면 사전 구성된 연결을 사용하세요. OAuth 앱을 만들거나 클라이언트 ID 또는 클라이언트 시크릿을 입력할 필요가 없습니다. 아래의 기본 제공 OAuth 섹션을 따르세요.
사용자 지정 OAuth 클라이언트: 기본 제공 OAuth를 사용할 수 없거나 조직에서 자체 OAuth 클라이언트를 사용해야 하는 경우 이 방법을 따르세요. 아래의 사용자 지정 OAuth 클라이언트 섹션을 따르세요.
설정 개요
ChatGPT 계정 또는 워크스페이스에 사용할 Databricks 앱 연결을 만듭니다. 두 방법 모두 ChatGPT에서 요청하는 Databricks 제공업체 정보와 사용할 리소스에 대한 권한이 필요합니다. 사용자 지정 OAuth 클라이언트를 사용한다면 다음 항목도 준비하세요.
Databricks 계정 콘솔에서 생성한 Databricks OAuth 앱 연결.
Databricks OAuth 클라이언트 ID 및 클라이언트 시크릿.
ChatGPT에서 정확히 복사한 콜백 URL.
활성화하려는 커넥터 기능에 맞는 Databricks 범위.
워크스페이스 호스트, 계정 호스트, 계정 ID, 웨어하우스 등 ChatGPT 설정 과정에서 요청하는 Databricks 제공업체 정보.
시작하기 전에
다음 사항을 준비하거나 확인하세요.
ChatGPT 워크스페이스 관리자 또는 소유자 권한, 혹은 ChatGPT Plus 또는 Pro 계정.
사용자 지정 OAuth 클라이언트를 사용하는 경우 Databricks 계정 관리자 권한. 일부 작업은 워크스페이스 관리자 권한만으로 가능하지만, 사용자 지정 앱 연결은 Databricks 계정 콘솔에서 구성합니다. 기본 제공 OAuth를 사용하려면 Databricks 관리자가 ChatGPT 애플리케이션을 사용할 수 있고 해당 워크스페이스에 활성화되어 있는지 확인해야 합니다.
사용자 지정 OAuth 클라이언트를 사용하는 경우 별도 탭에 Databricks 계정 콘솔을 열어 두세요.
사용자 지정 OAuth 클라이언트를 사용하는 경우 정확한 콜백 URL을 복사할 수 있도록 ChatGPT에서 Databricks Genie 연결 화면을 열어 두세요.
앱에 일반 Databricks API 액세스가 필요한지, Databricks SQL 액세스만 필요한지 결정하세요.
사용자 지정 OAuth 클라이언트를 사용하는 경우 Databricks 클라이언트 시크릿을 안전하게 관리할 장소를 마련하세요.
Databricks 계정이나 워크스페이스에서 IP 액세스 목록, 컨텍스트 기반 인그레스 제어, 방화벽 또는 기타 네트워크 정책으로 액세스를 제한한다면, 현재 ChatGPT 커넥터 송신 IP 범위를 허용할 수 있는 Databricks 관리자의 도움이 필요합니다.
사용자 지정 OAuth 클라이언트를 사용하는 경우 ChatGPT에 표시된 콜백 URL을 정확히 복사하세요.
준비할 값
사용자 지정 OAuth 클라이언트를 사용하는 경우 콜백 URL: ChatGPT 커넥터 설정 과정에서 복사하세요.
사용자 지정 OAuth 클라이언트를 사용하는 경우 Databricks OAuth 클라이언트 ID.
사용자 지정 OAuth 클라이언트를 사용하는 경우 Databricks OAuth 클라이언트 시크릿.
사용자 지정 OAuth 클라이언트를 사용하는 경우 모든 API 또는 SQL 등 앱 기능에 적합한 Databricks 액세스 범위.
ChatGPT 설정 과정에서 요청하는 Databricks 워크스페이스 또는 계정 필드 값.
기본 제공 OAuth
먼저 위의 사전 준비 사항을 완료하세요. ChatGPT에서 기본 제공 OAuth를 사용할 수 있고 Databricks 워크스페이스에 활성화되어 있는 경우에만 이 방법을 사용하세요.
Databricks 관리자에게 계정 콘솔의 앱 통합 설정에서 ChatGPT 애플리케이션을 사용할 수 있고 해당 워크스페이스에 활성화되어 있는지 확인해 달라고 요청하세요. Databricks 계정 콘솔에 ChatGPT 애플리케이션이 표시되지 않는다면 Databricks 계정 담당자에게 문의하여 해당 계정에서 이 기능을 사용할 수 있는지 확인하세요.
ChatGPT에서 앱을 사용할 계정 또는 워크스페이스로 전환하세요. 개인용으로 설정하려면 설정 > 플러그인으로 이동하세요. 워크스페이스용으로 설정하려면 워크스페이스 관리자 또는 소유자로 워크스페이스 설정 > 플러그인으로 이동하세요.
Databricks Genie를 선택한 다음 앱 연결 추가를 선택하세요.
https://및 URL 경로를 제외하고 워크스페이스 호스트 이름(필수)을 입력하세요.계속을 선택한 다음 Databricks에 로그인하고 동의 요청을 검토하세요.
아래의 연결 및 테스트와 액세스 관리 섹션을 계속 진행하세요. 사용이 허용된 멤버의 테스트와 워크스페이스 액세스 확인도 포함됩니다.
사용자 지정 OAuth 클라이언트
먼저 위의 사전 준비 사항을 완료하세요. 기본 제공 OAuth를 사용할 수 없거나 조직에서 자체 OAuth 클라이언트를 사용해야 하는 경우 이 방법을 따르세요. 설정 후 아래의 연결 및 테스트와 액세스 관리 절차를 완료하세요.
ChatGPT에서 사용자 지정 OAuth 설정 시작하기
ChatGPT에서 앱을 사용할 계정 또는 워크스페이스로 전환하세요.
개인용으로 설정하려면 설정 > 플러그인으로 이동하세요. 워크스페이스용으로 설정하려면 워크스페이스 관리자 또는 소유자로 워크스페이스 설정 > 플러그인으로 이동하세요.
디렉터리에서 Databricks Genie를 선택하세요.
앱 연결 추가를 선택하세요.
Databricks Genie 연결 대화 상자에서 OAuth 클라이언트 섹션을 찾으세요.
ChatGPT에서 콜백 URL을 복사하세요. 이 대화 상자를 열어 두세요.
콜백 URL 예시:
https://chatgpt.com/connector/oauth/<callback_id>
콜백 ID를 삭제하거나, 끝에 슬래시를 추가하거나, 일반적인 ChatGPT URL로 바꾸지 마세요. Databricks에 등록한 URL은 ChatGPT에 표시된 콜백 URL과 정확히 일치해야 합니다.
Databricks에서 사용자 지정 OAuth 앱 연결 만들기
사용 중인 Databricks 계정의 Databricks 계정 콘솔을 여세요.
왼쪽 사이드바에서 설정을 여세요.
앱 연결 탭을 여세요.
연결 추가를 선택하세요.
ChatGPT Databricks 커넥터와 같은 애플리케이션 이름을 입력하세요.
리디렉션 URL에 ChatGPT에서 복사한 콜백 URL을 그대로 붙여넣으세요.
액세스 범위에서 앱에 필요한 범위를 선택하세요.
SQL 외의 Databricks API도 필요한 일반 Databricks 앱에는 모든 API를 사용하세요.
Databricks SQL API만 사용하는 앱에는 SQL만 사용하세요.
나중에 ChatGPT에 입력할 모든 범위가 이 Databricks OAuth 앱에서 활성화되어 있는지 확인하세요. Databricks는 UI에서 생성한 앱에 openid, email, profile, offline_access를 자동으로 허용합니다.
조직에 별도의 정책이 없다면 토큰 TTL을 Databricks 기본값으로 유지하세요. 액세스 토큰은 60분, 새로 고침 토큰은 10080분입니다.
클라이언트 시크릿 생성을 켜세요. 이 절차에서 ChatGPT는 기밀 OAuth 클라이언트가 필요합니다.
연결을 생성하세요.
Databricks에서 자격 증명 복사하기
연결 생성 완료 대화 상자에서 클라이언트 ID를 복사하세요.
클라이언트 시크릿을 즉시 복사하여 안전하게 보관하세요.
시크릿을 복사하기 전에 대화 상자를 닫았다면 OAuth 앱 자격 증명을 생성하거나 교체하고 새 시크릿을 사용하세요.
Databricks는 시크릿을 한 번만 표시합니다. 자격 증명과 동일하게 취급하고 스크린샷, 지원 티켓, 댓글 또는 채팅에 포함하지 마세요.
ChatGPT에서 사용자 지정 OAuth 설정 완료하기
Databricks Genie 연결 대화 상자로 돌아가세요.
OAuth 클라이언트 ID에 Databricks 클라이언트 ID를 입력하세요.
OAuth 클라이언트 시크릿에 Databricks 클라이언트 시크릿을 입력하세요.
범위(선택 사항)에 앱의 Databricks 엔드포인트와 기능에 필요한 범위를 입력하세요. Databricks OAuth 앱에서 활성화된 범위와 일치시켜 주세요.
한 줄에 범위 하나를 입력하거나 쉼표로 범위를 구분하세요. ChatGPT에 입력한 모든 범위는 Databricks OAuth 앱에서 활성화되어 있어야 합니다.
https:// 및 URL 경로를 제외하고 워크스페이스 호스트 이름(필수)을 입력하세요. 설정 과정에 표시되는 다른 필수 Databricks 제공업체 필드도 입력하세요.
계속을 선택하세요.
ChatGPT는 범위(선택 사항)에 입력한 범위만 정확히 요청합니다. 더 넓은 템플릿 범위를 자동으로 추가하지 않습니다.
연결 및 테스트
어느 OAuth 방법을 사용하든 다음 연결 테스트와 액세스 확인을 완료하세요.
커넥터 세부 정보, 작업, 인증 설정을 검토하세요.
워크스페이스 관리자라면 워크스페이스에서 커넥터를 활성화하고 워크스페이스 정책에 따라 사용할 수 있는 사용자를 설정하세요.
사용이 허용된 테스트 사용자로 ChatGPT에서 연결 절차를 시작한 다음 Databricks에 로그인하세요.
브라우저에서 의도한 Databricks 계정 또는 워크스페이스가 열리는지 확인하세요.
요청된 범위를 검토한 다음 승인을 선택하세요.
브라우저가 ChatGPT로 돌아오고 커넥터가 연결됨으로 표시되는지 확인하세요.
먼저 현재 사용자 정보를 가져오거나 승인된 Databricks SQL 리소스를 쿼리하는 등 위험도가 낮은 읽기 작업을 실행하세요.
쓰기 작업이 활성화되어 있다면 사용을 확대하기 전에 위험도가 확실히 낮은 Databricks 워크플로로 테스트하세요.
워크스페이스용으로 설정하는 경우, 관리자 권한이 없고 사용이 허용된 워크스페이스 멤버에게 연결 후 위험도가 낮은 테스트를 반복하도록 요청하세요.
액세스 관리
액세스 제어에는 Databricks와 ChatGPT가 모두 관여합니다.
ChatGPT에서는 워크스페이스 관리자가 앱의 사용 가능 여부와 멤버의 사용 방식을 관리합니다. Business에서는 관리자가 워크스페이스 전체에서 앱을 활성화할지 관리합니다. Databricks 앱의 관리자 제어 설정(워크스페이스 설정 > 앱)에서 다음 항목을 확인하세요.
사용자 액세스: 지원되는 Enterprise 및 Edu 워크스페이스에서 커넥터를 사용할 수 있는 워크스페이스 역할을 설정합니다.
작업 제어: 활성화할 Databricks 작업을 설정합니다.
앱 권한: ChatGPT가 커넥터를 사용하기 전에 멤버에게 확인을 요청할 시점을 설정합니다.
이 앱 권한은 ChatGPT 대화에 적용됩니다. 워크스페이스 에이전트는 제작자가 지정한 에이전트별 제어 설정에 따라 사용 가능한 앱 작업과 최종 사용자에게 승인을 요청할 시점을 결정합니다. 에이전트의 동작에 관한 내용은 Enterprise 및 Business용 ChatGPT 워크스페이스 에이전트를 참고하세요.
Databricks에서는 관리자가 OAuth 앱을 승인할 수 있는 사용자와 해당 사용자가 액세스할 수 있는 Databricks 리소스를 관리합니다. ChatGPT에서 앱을 활성화한 후에도 제공업체 권한이 계속 적용됩니다.
요금제별 앱 제어 설정은 앱의 관리자 제어, 보안 및 규정 준수를 참고하세요.
Databricks 커넥터 설정 문제 해결
리디렉션 URI 불일치: 사용자 지정 OAuth 클라이언트를 사용하는 경우 Databricks의 리디렉션 URL 값이 경로와 콜백 ID를 포함해 ChatGPT에 표시된 콜백 URL과 정확히 일치하는지 확인하세요. 콜백 ID를 삭제하거나, 끝에 슬래시를 추가하거나, 다른 ChatGPT 리디렉션 URL로 바꾸지 마세요.
시크릿 누락: 사용자 지정 OAuth 클라이언트를 사용하는 경우 Databricks 시크릿은 한 번만 표시됩니다. 복사하지 못했다면 새 클라이언트 시크릿을 생성하세요.
OAuth 앱을 바로 사용할 수 없음: Databricks에 따르면 OAuth 애플리케이션 업데이트를 처리하는 데 최대 30분이 걸릴 수 있습니다.
범위 부족 또는 불일치: 사용자 지정 OAuth 클라이언트를 사용하는 경우 ChatGPT의 범위(선택 사항)와 Databricks OAuth 앱의 액세스 범위를 비교하세요. ChatGPT가 요청하는 모든 범위가 해당 앱에서 활성화되어 있어야 합니다. 필요에 따라 일반 API 액세스 또는 SQL 전용 액세스 등 사용 중인 엔드포인트와 기능을 해당 범위가 지원하는지 확인하세요.
SQL 작업 실패: SQL 범위, 웨어하우스 구성, Databricks 권한을 확인하세요.
잘못된 ChatGPT 워크스페이스: 사용자가 커넥터를 연결할 ChatGPT 워크스페이스에서 커넥터를 생성하고 활성화하세요.
잘못된 Databricks 계정 또는 워크스페이스: 워크스페이스 호스트 이름(필수) 값을 확인한 다음 로그인 절차를 반복하여 Databricks에서 의도한 계정 또는 워크스페이스가 열리는지 확인하세요.
사용자가 연결할 수 없음: 사용자에게 Databricks 액세스 권한과 OAuth 앱을 승인할 권한이 있는지 확인하세요. Business에서는 앱이 워크스페이스 전체에서 활성화되어 있는지 확인하세요. 지원되는 Enterprise 및 Edu 워크스페이스에서는 ChatGPT의 사용자 액세스 설정에서 커넥터 사용을 허용하는지도 확인하세요.
Databricks 네트워크 정책이 커넥터를 차단함: Databricks에서 특정 소스 IP만 허용한다면 Databricks 관리자가 관련 계정 또는 워크스페이스의 IP 액세스 목록, 컨텍스트 기반 인그레스 제어, 방화벽 또는 기타 고객 관리 네트워크 규칙을 업데이트해야 합니다.
현재 ChatGPT 커넥터 송신 IP 범위에서 들어오는 인바운드 연결을 허용하세요.
Databricks 또는 고객이 관리하는 네트워크 계층에서 이 허용 목록을 설정하세요. 이는 ChatGPT 워크스페이스의 IP 허용 목록 설정과 별개입니다.
공개된 범위는 변경될 수 있습니다. 가능하면 JSON을 기반으로 업데이트를 자동화하세요.
네트워크 차단을 우회하려고 클라이언트 시크릿을 교체하거나 OAuth 범위를 변경하지 마세요. 먼저 Databricks가 커넥터의 소스 IP를 거부하고 있는지 확인하세요.