Oracle Database 자격 증명
n8n v2.29이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다: 이 노드들은 SSH 터널을 지원하지 않습니다. Oracle Database 서버에 사용자 계정을 생성하세요. 해당 서비스에 대한 자세한 내용은 Oracle Database documentation을 참고하세요.
이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다:
이 노드들은 SSH 터널을 지원하지 않습니다. Oracle Database 19c 이상이 필요합니다. Transparent Application Continuity(TAC), 샤딩(Sharding)과 같은 고급 Oracle Database 기능을 사용하려면 Oracle Client Libraries 19c 이상도 필요합니다.
사전 준비 사항#
Oracle Database 서버에 사용자 계정을 생성하세요.
지원하는 인증 방식#
- 데이터베이스 연결
관련 자료#
해당 서비스에 대한 자세한 내용은 Oracle Database documentation을 참고하세요.
데이터베이스 연결 사용하기#
이 자격 증명을 구성하려면 다음이 필요합니다:
- User 이름.
- 해당 사용자의 Password.
- Connection String: 연결할 Oracle Database 인스턴스입니다. 이 문자열은 Easy Connect 문자열이거나, tnsnames.ora 파일의 TNS Alias이거나, Oracle Database 인스턴스일 수 있습니다.
- Use Optional Oracle Client Libraries: Oracle Database의 고급 기능을 사용하려면 이 옵션을 켜세요. 이 옵션은 내부적으로 node-oracledb의 Thick 모드를 사용합니다. node-oracledb Thick 모드를 활성화하려면 추가 설정이 필요합니다. 자세한 내용은 Enabling Thick mode documentation을 참고하세요. 이 옵션은 공식 n8n docker 이미지에서는 사용할 수 없습니다.
- Use SSL: Connection String이 SSL을 사용하는 경우 이 옵션을 켜고 SSL 인증에 필요한 추가 세부 정보를 구성하세요.
- Wallet Password: Privacy Enhanced Mail(PEM) 형식으로 인코딩된 개인 인증서가 암호화되어 있는 경우 이를 복호화하기 위한 비밀번호입니다.
- Wallet Content: Oracle Database와 상호 TLS(mTLS) 연결을 설정하는 데 필요한 보안 자격 증명입니다.
- Distinguished Name: 인증서의 DN(Distinguished Name)과 일치시켜야 하는 DN입니다.
- Match Distinguished Name: 일반적으로 수행되는 인증서 검증 외에도 서버 인증서의 DN을 일치시켜야 하는지 여부입니다.
- Allow Weak Distinguished Name Match: 리스너와 서버 인증서를 모두 확인하는 보안 DN 일치 동작을 수행해야 하는지 여부입니다.
- Pool Min: 풀이 생성될 때 데이터베이스에 설정되는 연결 수입니다.
- Pool Max: 연결 풀이 늘어날 수 있는 최대 연결 수입니다.
- Pool Increment: 연결 요청이 현재 열려 있는 연결 수를 초과할 때마다 열리는 연결 수입니다.
- Pool Maximum Session Life Time: 연결 요청이 현재 열려 있는 연결 수를 초과할 때마다 열리는 연결 수입니다.
- Pool Connection Idle Timeout: 연결 요청이 현재 열려 있는 연결 수를 초과할 때마다 열리는 연결 수입니다.
- Connection Class Name: DRCP/PRCP 연결 클래스입니다. 자세한 내용은 Enabling DRCP를 참고하세요.
- Connection Timeout: 애플리케이션이 Oracle Net 연결을 설정하는 데 걸리는 제한 시간(초)입니다.
- Transport Connection Timeout: 데이터베이스 호스트에 대한 연결을 설정하기 위해 기다리는 최대 시간(초)입니다.
- Keepalive Probe Interval: keepalive probe를 전송하는 간격(분)입니다.
데이터베이스 연결 자격 증명을 설정하려면:
- n8n 자격 증명의 User에 데이터베이스 사용자 이름을 입력합니다.
- 해당 사용자의 Password를 입력합니다.
- n8n 자격 증명의 Connection String에 데이터베이스의 연결 문자열을 입력합니다.
- 데이터베이스가 SSL을 사용하고 연결에 대해 SSL을 구성하려면 자격 증명에서 이 옵션을 켭니다. 옵션을 켰다면 다음 필드에 Oracle Database SSL 인증서 정보를 입력합니다:
- Wallet Password 필드에 지갑 비밀번호가 있다면 이를 입력합니다.
- Wallet Content 필드의 'Expanded' 레이아웃에 PEM으로 인코딩된 지갑 파일인 ewallet.pem의 내용을 입력합니다. 이렇게 하면 PEM으로 인코딩된 지갑 파일의 모든 공백이 그대로 유지됩니다. Wallet Content 필드에 직접 복사해서 붙여넣으면 공백이 제거되어 연결 오류가 발생합니다.
TLS 연결 작업에 대한 자세한 내용은 node-oracledb를 참고하세요.