SMB 연결 구성
type: smb는 SMB 공유에 연결합니다. hostname에는 IP 주소, 로컬 네트워크 이름 또는 FQDN을 넣고 스킴은 넣지 않습니다. share는 유효한 공유 이름이어야 하며 baseDirectory를 지정하면 이 소스의 읽기와 쓰기가 해당 하위 디렉터리에서 수행됩니다.
메시지 서명 요청은 기본적으로 켜져 있습니다. requireMessageSigning: true일 때 서버가 메시지 서명을 지원하지 않으면 연결에 실패합니다. 프록시와 인증 자격 증명의 각 필수 필드를 함께 지정합니다.
생성 입력의 필드
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: smb. | smb |
proxy | object | 선택 | 모든 트래픽을 통과시킬 외부 통신 프록시입니다. | |
hostname | string | 필수 | SMB 공유를 제공하는 서버로 확인될 수 있는 IP 주소, 로컬 네트워크 이름(예: FS-SERVER-01) 또는 FQDN입니다. https://, smb:// 같은 프로토콜 표기는 넣지 않습니다. | |
port | integer | 선택 | 기본 포트는 445입니다. | |
auth | union<usernamePassword> | 필수 | ||
share | string | 필수 | 유효한 SMB 공유 이름이어야 합니다. | |
baseDirectory | string | 선택 | 이 소스의 모든 읽기와 쓰기가 수행될 하위 디렉터리입니다. | |
requireMessageSigning | boolean | 선택 | true이면 서버에 모든 메시지의 서명을 요청하며 서버가 서명을 지원하지 않으면 연결에 실패합니다. 기본값은 true입니다. |
proxy의 구조
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
hostname | string | 필수 | ||
port | integer | 필수 | ||
protocol | enum | 필수 | 허용값: HTTP, SOCKS. | HTTP |
auth의 구조
분기 usernamePassword
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: usernamePassword. | usernamePassword |
password | EncryptedProperty | 필수 | 조회 시에는 암호화된 값 대신 비밀 이름을 반환합니다. 쓸 때 평문 값을 전달하면 암호화하여 저장합니다. 비밀 이름을 전달하면 해당 속성의 기존 비밀 이름과 같아야 하며 기존 암호화 값을 유지합니다. | |
domain | string | 선택 | Windows 인증 도메인을 지정할 수 있습니다. 일반 DNS 도메인 규칙이 적용되며 .local 같은 최상위 도메인도 사용할 수 있습니다. 기본값은 WORKGROUP입니다. | |
username | string | 필수 |
password의 구조
입력과 조회에서 사용하는 값의 차이 및 두 분기의 전체 구조는 암호화 속성을 따릅니다.
필드 값 예시
다음 값은 지정한 필드에 넣는 가상 입력 구조입니다. 전체 연결 생성 요청과 구분하고, 실제 호스트와 역할, 자격 증명 및 드라이버가 지원하는 속성으로 바꿉니다.
smb.proxy
{
"protocol": "HTTP",
"hostname": "proxy.example.com",
"port": 8080
}