IAuthenticationExtension Interface

Represents an authentication extension in SQL Server Reporting Services.

Namespace:  Microsoft.ReportingServices.Interfaces
Assemblies:   Microsoft.ReportingServices.SharePoint.UI.WebParts (in Microsoft.ReportingServices.SharePoint.UI.WebParts.dll)
  Microsoft.ReportingServices.Interfaces (in Microsoft.ReportingServices.Interfaces.dll)

Syntax

'Declaration
Public Interface IAuthenticationExtension _
    Inherits IExtension
'Usage
Dim instance As IAuthenticationExtension
public interface IAuthenticationExtension : IExtension
public interface class IAuthenticationExtension : IExtension
type IAuthenticationExtension =  
    interface
        interface IExtension
    end
public interface IAuthenticationExtension extends IExtension

The IAuthenticationExtension type exposes the following members.

Properties

  Name Description
Public property LocalizedName Gets the localized name of the extension to be displayed in a user interface. (Inherited from IExtension.)

Top

Methods

  Name Description
Public method GetUserInfo Returns the current user identity.
Public method IsValidPrincipalName Indicates whether the specified principal name is valid.
Public method LogonUser Creates a logon session for the user associated with the given credentials.
Public method SetConfiguration Used to pass custom configuration data to an extension. (Inherited from IExtension.)

Top

Remarks

The IAuthenticationExtension interface in Reporting Services enables your security extension to specify a custom way for the report server to authenticate users. To create an authentication extension class, implement IAuthenticationExtension.

Your authentication extension should provide implementations for the LogonUser, GetUserInfo, and IsValidPrincipalName methods. Implementing IAuthenticationExtension enables your security extension to validate user credentials against a specified authority and enables the report server to access user information.

The primary way in which you can implement a custom authentication extension is through the use of Forms authentication. For more information, see "Forms Authentication Provider" in your .NET Framework Developer's Guide.