Authorization service interface

The authorization service provides entry points for use by the queue manager.

The entry points are as follows:

    MQZ_AUTHENTICATE_USER
    Authenticates a user ID and password, and can set identity context fields.

    MQZ_CHECK_AUTHORITY
    Checks whether an entity has authority to perform one or more operations on a specified object.

    MQZ_CHECK_PRIVILEGED
    Checks whether a specified user is a privileged user.

    MQZ_COPY_ALL_AUTHORITY
    Copies all the current authorizations that exist for a referenced object to another object.

    MQZ_DELETE_AUTHORITY
    Deletes all authorizations associated with a specified object.

    MQZ_ENUMERATE_AUTHORITY_DATA
    Retrieves all the authority data that matches the selection criteria specified.

    MQZ_FREE_USER
    Frees associated allocated resources.

    MQZ_GET_AUTHORITY
    Gets the authority that an entity has to access a specified object.

    MQZ_GET_EXPLICIT_AUTHORITY
    Gets either the authority that a named group has to access a specified object (but without the additional authority of the nobody group) or the authority that the primary group of the named principal has to access a specified object.

    MQZ_INIT_AUTHORITY
    Initializes authorization service component.

    MQZ_INQUIRE
    Queries the supported functionality of the authorization service.

    MQZ_REFRESH_CACHE
    Refresh all authorizations.

    MQZ_SET_AUTHORITY
    Sets the authority that an entity has to a specified object.

    MQZ_TERM_AUTHORITY
    Terminates authorization service component.

In addition, on IBM MQ for Windows, the authorization service provides the following entry points for use by the queue manager:

  • MQZ_CHECK_AUTHORITY_2
  • MQZ_GET_AUTHORITY_2
  • MQZ_GET_EXPLICIT_AUTHORITY_2
  • MQZ_SET_AUTHORITY_2

These entry points support the use of the Windows Security Identifier (NT SID).

These names are defined as typedef s, in the header file cmqzc.h, which can be used to prototype the component functions.

The initialization function ( MQZ_INIT_AUTHORITY ) must be the main entry point for the component. The other functions are invoked through the entry point address that the initialization function has added into the component entry point vector.