SmbjClientProviderService

Description

Provides access to SMB Sessions with shared authentication credentials.

Tags

samba, smb, cifs, files

Properties

In the list below required Properties are shown with an asterisk (*). Other properties are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.

Display NameAPI NameDefault ValueAllowable ValuesDescription
DomaindomainThe domain used for authentication. Optional, in most cases username and password is sufficient.
Enable DFS *enable-dfsfalse
  • true
  • false
Enables accessing Distributed File System (DFS) and following DFS links during SMB operations.
Hostname *hostnameThe network host of the SMB file server.
PasswordpasswordThe password used for authentication.
Port *port445Port to use for connection.
Share *shareThe network share to which files should be listed from. This is the “first folder”after the hostname: smb://hostname:port/[share]/dir1/dir2
SMB Dialect *smb-dialectAUTO
  • AUTO
  • SMB 2.0.2
  • SMB 2.1
  • SMB 3.0
  • SMB 3.0.2
  • SMB 3.1.1
The SMB dialect is negotiated between the client and the server by default to the highest common version supported by both end. In some rare cases, the client-server communication may fail with the automatically negotiated dialect. This property can be used to set the dialect explicitly (e.g. to downgrade to a lower version), when those situations would occur.
Timeout *timeout5 secTimeout for read and write operations.
Use Encryption *use-encryptionfalse
  • true
  • false
Turns on/off encrypted communication between the client and the server. The property’s behavior is SMB dialect dependent: SMB 2.x does not support encryption and the property has no effect. In case of SMB 3.x, it is a hint/request to the server to turn encryption on if the server also supports it.
UsernameusernameGuestThe username used for authentication.

State management

This component does not store state.

Restricted

This component is not restricted.

System Resource Considerations

This component does not specify system resource considerations.