Authentication Agent

1) Vista

These are the operations that are directly involved in Application¹ and User¹ authentication.

The authentication agent is responsible for providing easy access to the following Authentication Service operations:
  • Authentication of Applications
  • Authentication of Users
  • Session Management
The purpose of this agent is to provide the users of Digital Fortress with an easier approach to authentication operations.

2) Data Contracts

(Due to CodePlex limitations we're not allowed to show the same image as in Administration Agent. Please help us change it and vote in this workitem: Linking to images outside of the Wiki?)

3) Operations

3.1) Application AuthenticateApplication(Guid applicationId, String password)

Description

This method is responsible for authenticating an Application¹ in the security context with the given application's Guid and password.

Parameters

  • Guid applicationId - The application's General Unique Identifier.
  • String password - The password is used for authenticating the given application against the services (Authentication, Authorization and Administration). Please advise that only a hash of the password will be saved in the Digital Fortress Security Repository, and as such there's no way of retrieving this password. You can reset it though.

Returns

  • Application - Returns the the application with filled properties. If authentication fails a null value is returned.

Dependencies

Test Suite:

  1. Test successful authentication.
  2. Test unsuccessful authentication.
  3. Test passing a empty password, resulting in an expected fault (PassordRequiredFault).
  4. Test passing a empty application Guid, resulting in an expected fault (ApplicationRequiredFault).
  5. Test authenticatig a blocked application, resulting in an expected fault (ApplicationBlockedFault).

3.2) User AuthenticateUser(String username, String password)

Description

This method is responsible for authenticating an User¹ in the security context with the given username and password.

Parameters

  • String username - The Username.
  • String password - The password to be used for authenticating the given user. Please advise that only a hash of the password will be saved in the Digital Fortress Security Repository, and as such there's no way of retrieving this password. You can reset it though.

Returns

  • User - Returns the the user with filled properties. If authentication fails the User a null value is returned.

Dependencies

Test Suite:

  1. Test successful authentication.
  2. Test unsuccessful authentication.
  3. Test passing a empty password, resulting in an expected fault (PassordRequiredFault).
  4. Test passing a empty username, resulting in an expected fault (UsernameRequiredFault).
  5. Test authenticating a blocked user, resulting in an expected fault (UserBlockedFault).

¹Please refer to the Data Contracts image for clarifications on this contract.

Last edited Jun 19, 2007 at 4:17 AM by jcfigueiredo, version 20

Comments

No comments yet.