SQL Server Reporting Service (SSRS) - HTTP Status 401 Unauthorized Error

I am going to continue on writing article on SQL Server Reporting Services (Its because, it is providing me good fame on http://forums.asp.net, LOL ).

We have to deploy the reports on the the Reporting Services Virtual Directory (I can write the whole different article on the Reporting Deployment, but may be next time. Right now we don't want to go deep into that.). The Reporting Server Virtual Directory may exist on the different server. It is recommended to keep anonymous access off for Reports virtual directory if you are going to call reports on the web.

The anonymous access allows any user to access the page. But now when we are keeping anonymous access off for the Reports, it can create problem while fetching the report inside the Report Viewer control on any ASPX page.

The Report server will expect authorized user to access the reports. This can be done by two ways.

1. Passing the Report Server User Credentials with the Reports.
2. Forms Authentication on Reporting Server.

Today, I am going to explain that How can we pass the User Credentials of the Reporting Server with the report call.

We need to Create one sealed class to perform this action. This class need to be inherited from IReportServerCredential interface.

    [Serializable]
    public sealed class ReportServerNetworkCredentials : IReportServerCredentials
    {
        #region IReportServerCredentials Members

        /// <summary>
        /// Provides forms authentication to be used to connect to the report server.
        /// </summary>
        /// <param name="authCookie">A Report Server authentication cookie.</param>
        /// <param name="userName">The name of the user.</param>
        /// <param name="password">The password of the user.</param>
        /// <param name="authority">The authority to use when authenticating the user, such as a Microsoft Windows domain.</param>
        /// <returns></returns>
        public bool GetFormsCredentials(out System.Net.Cookie authCookie, out string userName,
            out string password, out string authority)
        {
            authCookie = null;
            userName = null;
            password = null;
            authority = null;

            return false;
        }

        /// <summary>
        /// Specifies the user to impersonate when connecting to a report server.
        /// </summary>
        /// <value></value>
        /// <returns>A WindowsIdentity object representing the user to impersonate.</returns>
        public WindowsIdentity ImpersonationUser
        {
            get
            {
                return null;
            }
        }

        /// <summary>
        /// Returns network credentials to be used for authentication with the report server.
        /// </summary>
        /// <value></value>
        /// <returns>A NetworkCredentials object.</returns>
        public System.Net.ICredentials NetworkCredentials
        {
            get
            {
                string userName = "SERVERUSERNAME";
                string domainName = "DOMAIN";
                string password = "somepassword";

                return new System.Net.NetworkCredential(userName, password, domainName);
            }
        }

        #endregion
    }

How to Utilize the ReportServerNetworkCredentials Class in your Report call on Page_Load event...

protected void Page_Load(object sender, EventArgs e)
{
    myReportViewer.ProcessingMode = Microsoft.Reporting.WebForms.ProcessingMode.Remote;
    
    // Here we are going to pass the ReportServerCredentials to the Report Viewer.
    myReportViewer.ServerReport.ReportServerCredentials = new ReportServerNetworkCredentials();
    
    ReportServerLoaction = ConfigurationManager.AppSettings["REPORT_SERVER_PATH"];
    myReportViewer.ServerReport.ReportServerUrl = new Uri("http://MyReportServer/Reports/");
    myReportViewer.ServerReport.ReportPath = "TempReports/MyFirstReport";
    myReportViewer.ShowParameterPrompts = false;
    myReportViewer.ShowPrintButton = true;

    Microsoft.Reporting.WebForms.ReportParameter[] reportParameterCollection = new Microsoft.Reporting.WebForms.ReportParameter[1];
    reportParameterCollection[0] = new Microsoft.Reporting.WebForms.ReportParameter();
    reportParameterCollection[0].Name = "ClientID";
    reportParameterCollection[0].Values.Add("49020644-63AA-4D92-81A1-8F85D49ACF67");
    
    myReportViewer.ServerReport.SetParameters(reportParameterCollection);
    myReportViewer.ServerReport.Refresh();
}

Please feel free to comment on the article. Critics are highly appreciated.