1.3 State and Flow Diagram (RFC Section 3)

The GroupWise 6.5 POA IMAP agent implemented a new Trusted Application Authenticated state.

NOTE:The GroupWise IMAP agents do not support pre-authenticated connections.

This section briefly outlines the following state and flow functions of IMAP:

1.3.1 Non-Authenticated State (RFC Section 3.1)

Full compliance.

The Trusted Application Authenticated state is entered from this state.

Trusted Application Authenticated State (RFC Section 3.1.1)

To enter the intermediate GroupWise Trusted Application Authenticated state, use the GroupWise XGWTRUSTEDAPP authentication mechanism (using the IMAP AUTHENTICATE command) and provide the Trusted Application credentials, as outlined in the GroupWise Trusted Application API documentation.

When the Authenticated state is entered from the Trusted Application Authenticated state, the LOGOUT command logs out the current user and returns to the Trusted Application Authenticated state. A LOGOUT command from the Trusted Application Authenticated state closes the connection.

Enter the Authenticated state by using the normal LOGIN command. The user's password is not required.

If a LOGIN command is issued while in the Authenticated state, the current user is first logged out, the connection returns to the Trusted Application Authenticated state, and the login is attempted.

Some GroupWise extensions are available in the Trusted Application Authenticated state, such as XGWTAULIST (which lists all the users on the current Post Office).

The GroupWise XGWTRUSTEDAPP extension to the AUTHENTICATE command uses the "+" continuation character to indicate the server’s readiness to receive the Trusted Application credentials.

1.3.2 Authenticated State (RFC Section 3.2)

Full compliance.

When the Authenticated state is entered from the Trusted Application Authenticated state, the LOGOUT command logs out the current user and returns to the Trusted Application Authenticated state. A LOGOUT command from the Trusted Application Authenticated state closes the connection.

If a LOGIN command is issued while in the Authenticated state, the current user is first logged out, the connection returns to the Non-Authenticated state, and the login is attempted.

1.3.3 Selected State (RFC Section 3.3)

Full compliance.

The GroupWise predefined folders named Work in Progress, Documents, and Contacts are not returned in the LIST response.

GroupWise also predefines several folder types (such as: query, IMAP, NNTP, hidden, or accepted). These folder types are not included in the LIST response.

1.3.4 Logout State (RFC Section 3.4)

Full compliance.

When the Authenticated state is entered from the Trusted Application Authenticated state, the LOGOUT command logs out the current user and returns to the Trusted Application Authenticated state. A LOGOUT command from the Trusted Application Authenticated state closes the connection.

To switch access to a different user's account (without having to disconnect and reconnect), use the LOGIN command. Using the LOGIN command (when you are already authenticated) logs out the current user, returns the connection to the Non-Authenticated state, and then tries to log into another user's account.