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

• Postgres
• Agent
• Postgres Chat Memory
• PGVector Vector Store

사전 준비 사항#

Postgres 서버에서 사용자 계정을 생성하세요.

지원되는 인증 방식#

• 데이터베이스 연결

관련 리소스#

서비스에 대한 자세한 내용은 Postgres 문서를 참고하세요.

데이터베이스 연결 사용하기#

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

• 서버의 호스트(Host) 또는 도메인 이름.
• 데이터베이스(Database) 이름.
• 사용자(User) 이름.
• 사용자 비밀번호(Password).
• SSL 문제 무시(Ignore SSL Issues): SSL 검증이 실패해도 자격 증명이 연결되도록 설정할지 여부.
• SSL: 연결에서 SSL을 사용할지 선택합니다.
• 연결에 사용할 포트(Port) 번호.
• SSH 터널(SSH Tunnel): Postgres 서버와의 네트워크 연결을 암호화하기 위해 SSH를 사용할지 선택합니다.

데이터베이스 연결을 설정하려면:

1. Postgres 서버의 호스트(Host) 또는 도메인 이름을 입력합니다. /conninfo 명령을 실행하여 호스트 이름을 확인하거나 다음 쿼리를 실행할 수 있습니다:

   SELECT inet_server_addr();
   

2. 데이터베이스(Database) 이름을 입력합니다. /conninfo 명령을 실행하여 데이터베이스 이름을 확인하세요.

3. 연결하려는 사용자의 사용자(User) 이름을 입력합니다.

4. 사용자의 **비밀번호(Password)**를 입력합니다.

5. SSL 문제 무시(Ignore SSL Issues): 이 설정을 켜면 SSL 검증이 실패하더라도 자격 증명이 연결됩니다.

6. SSL: 연결에서 SSL을 사용할지 선택합니다. 자세한 내용은 Postgres의 SSL 지원 문서를 참고하세요. 옵션은 다음과 같습니다:

   • Allow: ssl-mode 파라미터를 allow로 설정합니다. 먼저 비 SSL 연결을 시도하고, 실패하면 SSL 연결을 시도합니다.
   • Disable: ssl-mode 파라미터를 disable로 설정합니다. 비 SSL 연결만 시도합니다.
   • Require: ssl-mode 파라미터를 require로 설정합니다. SSL 연결만 시도합니다. 루트 CA 파일이 있는 경우, 신뢰할 수 있는 인증 기관(CA)이 서버 인증서를 발급했는지 확인합니다.

7. 연결에 사용할 포트(Port) 번호를 입력합니다. /conninfo 명령을 실행하여 호스트 이름을 확인하거나 다음 쿼리를 실행할 수 있습니다:

   SELECT inet_server_port();
   

8. SSH 터널(SSH Tunnel): SSH를 통해 데이터베이스에 연결하려면 이 설정을 켭니다. SSH 사용에 대한 안내는 SSH 터널 제한 사항을 참고하세요. 이 설정을 켠 후에는 다음이 필요합니다:

   1. SSH Authenticate with을 선택하여 구성할 SSH 터널 유형을 설정합니다:
      • SSH에 비밀번호로 연결하려면 Password를 선택합니다.
      • ID 파일(개인 키)과 패스프레이즈로 SSH에 연결하려면 Private Key를 선택합니다.
   2. 연결하려는 원격 바인드 주소를 SSH Host로 입력합니다.
   3. SSH Port: SSH 터널의 로컬 포트 번호를 입력합니다.
   4. SSH Postgres Port: 터널의 원격 쪽 끝, 즉 데이터베이스 서버가 사용 중인 포트 번호를 입력합니다.
   5. SSH User: 로그인할 사용자 이름을 입력합니다.
   6. SSH Authenticate with에서 Password를 선택한 경우, 사용자의 SSH Password를 추가합니다.
   7. SSH Authenticate with에서 Private Key를 선택한 경우:
      1. SSH에 사용할 Private Key 또는 ID 파일의 내용을 추가합니다.
      2. Private Key가 패스프레이즈와 함께 생성된 경우 해당 Passphrase를 입력합니다. Private Key에 패스프레이즈가 없으면 이 필드를 비워 둡니다.

자세한 내용은 SSH 터널을 이용한 안전한 TCP/IP 연결을 참고하세요.

SSH 터널 제한 사항#

다음 경우에만 SSH Tunnel 설정을 사용하세요:

• Postgres node와 함께 이 자격 증명을 사용하는 경우 (Agent node는 SSH 터널을 지원하지 않습니다).
• Postgres 서버와 동일한 머신에서 SSH 서버가 실행 중인 경우.
• ssh로 로그인할 수 있는 사용자 계정이 있는 경우.