메시지 전 및 메시지 후 웹훅에 대한 인증 방법 정의하기

이 문서는 watsonx Assistant 에서 메시지 전 웹훅 및 메시지 후 웹훅에 대한 인증을 구성하는 프로세스를 보여줍니다. 사용 가능한 인증 방법과 설정 방법에 대해 설명합니다.

개요

웹훅을 사용하면 외부 시스템이 watsonx Assistant 와 통신할 수 있습니다. 인증은 승인된 소스만 웹훅을 트리거할 수 있도록 합니다. 이 문서에서는 웹훅 인증을 구성하고 관리하는 프로세스를 설명하며, 웹훅 인증에 대한 업데이트된 방법을 소개합니다.

시작하기 전에

웹훅 인증을 구성하기 전에:

  • 환경에 쓰기 권한이 있어야 합니다.
  • 토큰 요청 URL(필요한 경우)과 비밀번호 또는 토큰과 같은 비밀을 포함하여 대상 서버의 인증 세부 정보가 있어야 합니다.

프로시저

  1. > 환경으로 이동합니다.

  2. 초안 탭 > 초안 환경 또는 라이브 탭 > 라이브 환경 중 하나에서 설정 톱니바퀴 아이콘을 선택합니다.

  3. 정의하려는 내용에 따라 메시지 전 웹훅 또는 메시지 후 웹훅 중에서 선택합니다.

  4. 아래로 스크롤하여 웹훅 설정으로 이동한 후 API를 붙여넣기 URL.

  5. 인증 편집을 클릭하여 인증 설정 페이지를 엽니다.

  6. 드롭다운에서 다음 옵션 중 하나를 선택합니다:

  7. 저장 을 클릭하십시오.

인증 없음

이는 기본 옵션입니다.

기본 인증

  1. 사용자 아이디와 비밀번호를 입력합니다.

무기명 인증

  1. 무기명 토큰을 입력합니다.

API 키 인증

  1. API 키 이름과 API 키를 입력합니다.

서명된 JWT

  1. 비밀번호를 입력합니다.
  2. 비밀번호 표시 아이콘 보기 아이콘을 클릭하여 비밀번호를 확인합니다.

OAuth 2.0

범위 문자열을 사용하는 경우 대상 서버에서 정의한 하나 이상의 인증 범위가 공백으로 구분된 집합이어야 합니다. 예를 들어 쓰기, 읽기+쓰기, 이메일 읽기 등이 있습니다.

  1. 보조금 유형에서 다음 옵션 중 하나를 선택합니다:

  2. 저장 을 클릭하십시오.

비밀번호

  1. 웹훅의 사용자 아이디를 입력합니다.

  2. 웹훅 서비스의 비밀번호를 입력합니다.

  3. 웹훅 인증 서비스의 클라이언트 ID를 입력합니다.

  4. 웹훅을 인증할 클라이언트 비밀번호를 입력합니다.

  5. 토큰 URL 입력하세요.

  6. 새로 고침 토큰 URL 입력하세요.

  7. 선택 사항: 서비스에 범위 문자열이 필요한 경우 대상 서버에 정의된 대로 범위 문자열을 입력합니다.

  8. 클라이언트 인증에서 다음 옵션 중 하나를 선택해야 합니다:

    • 기본 인증 헤더로 전송합니다: 인증 자격 증명이 HTTP 헤더로 전송됩니다.
    • 본문으로 보내기를 클릭합니다: 인증 자격 증명이 요청 본문으로 전송됩니다.
  9. 예를 들어 Header 접두사를 입력합니다: 무기명.

클라이언트 신임 정보

  1. 웹훅 인증 서비스의 클라이언트 ID를 입력합니다.

  2. 웹훅을 인증할 클라이언트 비밀번호를 입력합니다.

  3. 토큰 URL 입력하세요.

  4. 새로 고침 토큰 URL 입력하세요.

  5. 선택 사항: 서비스에 범위 문자열이 필요한 경우 대상 서버에 정의된 대로 범위 문자열을 입력합니다.

  6. 클라이언트 인증에서 다음 옵션 중 하나를 선택해야 합니다:

    • 기본 인증 헤더로 전송합니다: 인증 자격 증명이 HTTP 헤더로 전송됩니다.
    • 본문으로 보내기를 클릭합니다: 인증 자격 증명이 요청 본문으로 전송됩니다.
  7. 예를 들어 Header 접두사를 입력합니다: 무기명.

권한 코드

  1. 웹훅 인증 서비스의 클라이언트 ID를 입력합니다.

  2. 인증 서버 URL 를 입력합니다.

  3. 토큰 URL 입력하세요.

  4. 새로 고침 토큰 URL 입력하세요.

  5. 선택 사항: 서비스에 범위 문자열이 필요한 경우 대상 서버에 정의된 대로 범위 문자열을 입력합니다.

  6. 클라이언트 인증에서 다음 옵션 중 하나를 선택해야 합니다:

    • 기본 인증 헤더로 전송합니다: 인증 자격 증명이 HTTP 헤더로 전송됩니다.
    • 본문으로 보내기를 클릭합니다: 인증 자격 증명이 요청 본문으로 전송됩니다.
  7. 예를 들어 Header 접두사를 입력합니다: 무기명.

  8. 선택 사항입니다: 대상 서버에 따라 리디렉션 URL을 OAuth 앱의 '콜백 URL ' 필드에 복사합니다.

  9. 액세스 권한 부여를 클릭합니다.

  10. 부여 서버에서 제시하는 페이지의 단계를 완료합니다.

  11. 어시스턴트로 다시 리디렉션되고 편집 모달이 다시 열립니다.

  12. 필드가 표시되면 클라이언트 ID 아래에 클라이언트 비밀번호를 입력합니다.

사용자 정의

  1. 웹훅의 사용자 지정 부여 유형 이름을 입력합니다.

  2. 토큰 URL 입력하세요.

  3. 새로 고침 토큰 URL 입력하세요.

  4. 선택 사항: 서비스에 범위 문자열이 필요한 경우 대상 서버에 정의된 대로 범위 문자열을 입력합니다.

  5. 클라이언트 인증에서 다음 옵션 중 하나를 선택해야 합니다:

    • 기본 인증 헤더로 전송합니다: 인증 자격 증명이 HTTP 헤더로 전송됩니다.
    • 본문으로 보내기를 클릭합니다: 인증 자격 증명이 요청 본문으로 전송됩니다.
  6. 예를 들어 Header 접두사를 입력합니다: 무기명.

애플리케이션에 사용자 지정 비밀번호를 추가해야 하는 경우 다음 단계를 따르세요:

  1. 비밀번호 추가 +를 클릭합니다.

  2. 시크릿 이름과 시크릿 값을 입력합니다.

  3. 선택 사항: 비밀번호 이름과 비밀번호 값을 더 추가하려면 비밀번호 추가 +를 클릭합니다.

  4. 매개변수 추가 +를 클릭합니다.

  5. 파라미터 이름과 파라미터 값을 입력합니다.

  6. 선택 사항: 매개변수 이름과 매개변수 값을 더 추가하려면 매개변수 추가 +를 클릭합니다.