Specify Credentials in Report Builder

Credentials authenticate the user who is attempting to retrieve data from a source of data. The owner of the source of data determines the type of credentials that must be used. For example, a database administrator might specify that the user must provide a Windows username and password.

In a report definition, each data source definition specifies a name, a connection string, whether to use integrated security, and what prompt to display if credentials are required but not specified. Credentials are not saved in the report definition. After a report is published on the report server, data sources can be managed independently from a report definition. Data source owners can specify credentials for both embedded and shared data sources on the report server.

Note

The report server administrator must grant a user the appropriate permissions to browse the report server to select shared data sources or models or to open or save reports. For more information, see Installing, Uninstalling, and Supporting Report Builder.

Note

You can create and modify report definitions (.rdl) in Report Builder and in Report Designer in SQL Server Data Tools. Each authoring environment provides different ways to create, open, and save reports and related items. For more information, see Designing Reports in Report Designer and Report Builder (SSRS) on the Web at microsoft.com.

Understanding When Credentials are Used

In Report Builder, credentials are often used when you connect to a report server or for data-related tasks, such as creating an embedded data source, running a dataset query, or previewing a report. Credentials are not stored in the report. They are managed separately on the report server or on the local client. The following list describes the types of credentials that you might need to provide, where they are stored, and how they are used:

  • Report server credentials that you enter in the Reporting Services Login Dialog Box (Report Builder).

    When you first save to, publish to, or browse to a report server or SharePoint site, you might need to enter your credentials. The credentials that you enter are used until the Report Builder session ends. If you choose to save the credentials, they are stored securely with your user settings on your computer. In subsequent Report Builder sessions, saved credentials are used to connect to the same report server or SharePoint site. The report server administrator or SharePoint administrator specifies which type of credentials to use.

  • Data source credentials that you enter in the Data Source Properties Dialog Box, Credentials (Report Builder) page for an embedded data source.

    These credentials are used by the report server to make a data connection to the external data source. For some types of data sources, credentials can be stored securely on the report server. These credentials enable other users to run the report without providing credentials for the underlying data connection.

  • Data source credentials that you enter in the Enter Data Source Credentials Dialog Box (Report Builder) when you run a dataset query, refresh dataset fields, or preview the report.

    These credentials are used to make a data connection from Report Builder to the external data source, or to preview a report that is configured to prompt for credentials. Credentials that you enter in this dialog box are not stored on the report server and are not available for use by other users. Report Builder caches the credentials during the report editing session so that you do not need to enter them every time you run the query or preview the report.

    For shared data sources, use the Save my password option to save the credentials locally with your user settings on your computer. Report Builder uses the saved credentials every time a connection is made to the corresponding external data source.

For more information, see Data Source Properties Dialog Box, General (Report Builder) and Previewing Reports in Report Builder.

Types of Credentials

The type of credentials that a data source supports is specified by the owner of the data source. For example, to access a SQL Server database, you might need to provide a SQL Server login user name and password. To access a different data source, you might need to provide a Windows user name and password. Some data sources might not require credentials.

Options for Specifying Credentials

The following options are available to specify credentials for a data source:

  • Use the current Windows user (also known as integrated security).

  • Use a stored user name and password.

  • Prompt the user for credentials.

  • No credentials are required.

Windows Integrated Security

When you select Use Windows Authentication (integrated security), the security token of the current user is passed to the data source. In this case, the user is not prompted to type a user name or password. This option usually requires that delegation features are enabled. If these features are not enabled, you can only use this option to access a data source that is located on the same computer.

User Name and Password Login

When you select Use this user name and password, a user name and password must be supplied to access the data source. For a SQL Server database, the credentials might be for a database login. The credentials are passed to the data source for authentication. 

Prompted Credentials

When you specify prompted credentials, each user who accesses the report must enter a user name and password to retrieve the data. This option is recommended for reports that contain confidential data. Prompted credentials can be for a Windows account or a database login. If the database server does not recognize the credentials that you provide, or if the specified user does not has not been granted permission to retrieve the data, the connection fails.

No Credentials

Credentials are not required for this data source. To run this report on the report server, the unattended execution account must be configured. For more information, see Configure the Unattended Execution Account in the Reporting Services documentation in SQL Server Books Online.

See Also

Tasks

Add and Verify a Data Connection or Data Source (Report Builder and SSRS)

Reference

Report Builder Options Dialog Box, Settings (Report Builder)

Concepts

Installing, Uninstalling, and Supporting Report Builder

Embedded and Shared Data Connections or Data Sources (Report Builder and SSRS)

Data Connections, Data Sources, and Connection Strings in Report Builder

Add Data to a Report (Report Builder and SSRS)