configure-the-web-portal-to-pass-custom-authentication-cookies.md

title	description	author	ms.author	ms.date	ms.service	ms.subservice	ms.topic	ms.custom	helpviewer_keywords
Configure the web portal to pass custom authentication cookies	Configure the web portal to pass custom authentication cookies	maggiesMSFT	maggies	04/18/2017	reporting-services	security	conceptual	updatefrequency5	authentication [Reporting Services] extensions [Reporting Services], custom security

Configure the web portal to pass custom authentication cookies

If you're using a custom authentication extension, you should configure the web portal to transmit custom authentication cookies. Otherwise, the web portal transmits cookies through HTTP requests specific to the report server. If you want to transmit other cookies, you must modify the RSReportServer.Config file.

Modify the RSReportServer.Config file

You can enable the [!INCLUDEssRSWebPortal] to transmit other cookies through to the report server by adding a <PassThroughCookies> element to the web portal configuration settings in the RSReportServer.config file. Transmitting other cookies is helpful in a single sign-on authentication solution that requires not only the report server authentication cookies, but also cookies from a third-party authentication system.

To enable other cookies to be transmitted through HTTP requests by using the web portal, set the following elements in the RSReportServer.config file:

<UI>  
   <CustomAuthenticationUI>  
      ...  
      <PassThroughCookies>  
         <PassThroughCookie>cookiename1</PassThroughCookie>  
         <PassThroughCookie>cookiename2</PassThroughCookie>  
      </PassThroughCookies>  
   </CustomAuthenticationUI>  
      ...  
</UI>  

Related content

Authentication with the report server
RsReportServer.config configuration file
Security extensions overview
Configure and administer a report server (SSRS Native Mode)
More questions? Try the Reporting Services forum