3.1.1 Connecting and Opening a Virtual Disk
Goal
To create a connection and open a virtual disk on an SMB3 share.
Context of use
The user wants access to a virtual disk to access its contents. A connection has to be established to the virtual disk first.
Actors
Application: The application is the primary actor that triggers this use case.
Authentication Service: The Authentication Service (AS) is a supporting actor that is used for authentication purposes.
File Client: The file client is a supporting actor that implements client-side protocol components and consumes the file services that are offered by the file server.
File Server: The file server is a supporting actor and implements server-side protocol components and the file services that are consumed by the file client.
Preconditions
The virtual disk has already been created and hosted on an SMB3 share.
The user has located the path of the virtual disk.
The user has permissions to access the virtual disk.
Main success scenario
Trigger: Based on interactions with the user, the application requests that the virtual disk be opened.
The application requests that the file client make a connection to and open the virtual disk.
The file client first establishes the connection with the file server, as described in [MS-SMB2] section 3.2.4.2.
The file server authenticates the user through the mechanisms described in [MS-AUTHSOD].
If the connection is successful, the file client opens the virtual disk on the file server, as described in [MS-SMB2] section 3.2.4.3.
The file server processes the open request, as described in [MS-SMB2] section 3.3.5.9.
The file client returns a handle for the virtual disk to the application, as described in [MS-SMB2] section 3.2.5.7.3.
Postcondition
The application can now use the file handle to read and write to the virtual disk.
Variations
None.