login¶
The login command allows an existing user to log in to the Datawire Connect Identity Server.
Syntax¶
The basic syntax of the login command is:
dwc login userEmail
The full syntax (excepting top level arguments) is:
dwc ... login -h --password <password> --org-id <orgId> --verify <userEmail>
More information about each command argument can be found under arguments.
Expected Response¶
Successful calls will result in the following response:
Now logged in as [<orgId>]<email>
where <orgId> is the Datawire ID for the new organization and <email> is the email address of its creator.
Common Error States¶
The most common error encountered with this call is that the user supplies the wrong password. If this occurs, please try again to ensure that you did not make a typo.
If you specify an organization ID in the call and it does not match the one stored for your user (correlated by email address) an error will also be thrown. In this case, you may use the status command to retrieve the proper organization ID and try again.
Arguments¶
The following arguments are supported for the login command:
- -h
- –password
- –org-id
- –verify
- <userEmail>
-h¶
-h is described under general command arguments.
–password¶
Optional. Allows the user to specify his password directly in the command.
Constraints and Usage Notes¶
If omitted, the user is prompted to enter a password interactively after submitting the command.
–org-id¶
Optional. Allows the user to specify his organization ID directly in the command.
Constraints and Usage Notes¶
If omitted, the organization ID is taken from the user’s stored state information.
–verify¶
–verify is described under general command arguments.