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.

Equivalent Options

The following arguments are equivalent to –password:

  • –pw

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.

Equivalent Options

The following arguments are equivalent to –org-id:

  • –organization-id
  • –orgid

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.

<userEmail>

Required. Indicates an email address for the user trying to log in.

Equivalent Options

This argument does not have a corresponding flag. It is determined by position within the command.

Constraints and Usage Notes

The email address must be the last argument supplied with the command.