Share via

Registering Your .NET Passport Site

  • Article

Registering Your .NET Passport Site

The .NET Services Manager is a Web utility used by participating sites to supply or change registration information, receive Site IDs, and download encryption keys.

You need a Site ID and Preproduction (PREP) encryption key to access Microsoft® .NET Passport servers and encrypt the communication—including the user's profile information—between the Passport Manager (at your site) and the .NET Passport servers. Whenever your servers make a call to the .NET Passport network servers, Microsoft .NET Passport uses your Site ID to access the values for your site. These values are the information you provide when you register.

Note You must complete your implementation and test it from end to end in the PREP environment before you can go live in the Production environment. For more information, see .NET Passport Environments.

To register your site in the PREP environment

Go to .NET Services Manager and select the option to Create and Manage an Application.

You will be asked to supply the following information:

User Information

  • First Name
  • Last Name
  • Job Function
  • Department
  • Country
  • Contact E-mail

General .NET Passport Information

  • Web Site Title: The common name of your site. This is how .NET Passport will refer to your site on the .NET Passport pages, including the site directory. Example: Adventure Works.

  • Domain Name: The top-most domain name of your site. For example, if you are implementing on both https://shopping.adventure-works.com/ and https://checkout.adventure-works.com/, then your domain name is adventure-works.com.

  • Default Return URL: The default location to which .NET Passport will redirect your customers in the event of an error or when you do not specify a ru parameter (for sites using the Passport Manager object) or the strReturnUrl parameter (for sites using the PassportIdentity object). This URL must fall under your domain name (for example, https://www.adventure-works.com/return.asp).

  • Customer Support Phone Number (optional): A telephone number, preferably a toll-free number, for your companys customer support department. If this is an international phone number, include the country code.

  • Customer Support E-mail (optional): The e-mail address for your companys customer support department.

  • Customer Support URL (optional): The location of your sites online customer support pages.

  • Privacy Policy URL: The location of your sites privacy policy.

Cobranding Information

  • Cobrand URL (optional): The location for the cobranding file on your site that creates the JavaScript cobranding variables. If you make it available, Microsoft .NET Passport will call this URL to retrieve parameters that enable the .NET Passport pages to be cobranded in specific areas. If you specify this URL, the file it references must be of nonzero length. If you leave this field blank, Microsoft .NET Passport pages will be rendered using their default text and messaging.
  • Cobrand CSS URL (optional): The location of the cascading style sheet file for your site that will be applied to the .NET Passport pages you cobrand. If you specify this URL, the file it references must be of nonzero length. If you leave this field blank, Microsoft .NET Passport pages are rendered using default styles.
  • Cobrand Image URL: The location of your site's logo, which should be 468 × 60 pixels and will appear in the upper-left corner of all .NET Passport pages that you can cobrand.
  • Cobrand Image2 URL (optional): The location of your site's logo, which must be 102 × 80 pixels and in Graphics Interchange Format (GIF). The logo will appear at the top of the .NET Passport Credential box and can be viewed in Microsoft® Internet Explorer 6.0 and later. Please make sure this URL contains a file name for the image. This URL must contain a file name for the image.
  • Cobrand Image HREF (optional): The location where .NET Passport will send your customers if they click your logo—for example, https://www.adventure-works.com. If you do not specify a location, the logo will not be a link.
  • Cobrand Instruction Text (optional): This is the instruction text that appears at the top of the .NET Passport Credential box and can be viewed in Internet Explorer 6.0 and later. This is a UTF8-encoded string.

Other .NET Passport Information

  • Registration Return URL (optional): The default location to which .NET Passport will redirect your customers after the initial registration process if you do not specify a ru parameter (for sites using the Passport Manager object) or a strReturnUrl parameter (for sites using the PassportIdentity object). This URL must fall under your domain name.
  • Terms of Use URL (optional): The location of your Terms of Use statement.
  • Edit URL (optional): The location of a page on your site where users can view, edit, or delete information stored on your site.
  • Disable Copyright: Select the check box to disable the copyright link in every .NET Passport module. If you choose this option, you must include a link to the Microsoft copyright statement in your cobranded area.
  • Disable Help Text: Select the check box to disable the Help link in every .NET Passport module. If you choose this option, you must provide a link within the cobranded area to relevant .NET Passport Help topics and you must link to .NET Passport Member Services from there.
  • Disable Member Services: Select the check box to disable the link to .NET Passport's Member Services Web site in every .NET Passport module. If you choose this option, you must provide a link within the cobranded area to relevant .NET Passport Help topics and you must link to .NET Passport Member Services from there.
  • Disable Privacy Policy: Select the check box to disable the privacy policy link in every .NET Passport module. To enable this option, you must have either a link in your cobranded area to your privacy policy that dynamically includes the specified paragraph of .NET Passport privacy text, or a link to the full .NET Passport privacy statement as the only privacy statement on the page.
  • Disable Terms of Use: Select the check box to disable the Terms of Use link in every .NET Passport module. To enable this option, you must modify your Terms of Use to dynamically include a paragraph of .NET Passport Terms of Use text that contains a link to the full .NET Passport Terms of Use through reverse cobranding.
  • Force JavaScript Detection: Select the check box to cause .NET Passport to detect whether JavaScript is enabled on the users browser. If your site cobrands the Sign-in page and requires JavaScript support to render that page completely, you may want to use this feature. If detection fails, a message is displayed to prompt the user to enable JavaScript before proceeding to the Sign-in page.

.NET Passport Single Sign-In Information

  • Expire Cookie URL: The location of the page that will delete all the cookies set by .NET Passport for your site. When a customer signs out of .NET Passport, the system calls this URL to clear all .NET Passport-related cookies set in your domain. This URL must fall under your domain name.
  • Logout URL (optional): The location to which .NET Passport will send your customers if they sign out of .NET Passport by clicking the Sign Out button on your site.

Kids Passport Information

  • Account Removal URL: Enables compliance with the provisions of children's privacy laws, such as the Children's Online Privacy Protection Act (COPPA), that require all data gathered about a child to be accessible and removable by the parent, and requires that the site contain either working code that removes the data in real time or a means of recording the fact that removal of data has been requested. In both cases, the relationship between the requesting parent user and the child for whom the account is deleted must be verified. Make sure this URL contains a file name and that the file is of nonzero length.
  • Account Data URL: Enables compliance with the provisions of children's privacy laws, such as COPPA, that require all data gathered about a child to be accessible and removable by the parent. The Account Data URL should contain either working code that allows viewing and editing the data in real time, or instructions for how the data can be requested. In both cases, the relationship between the requesting parent user and the child for whom data is being requested must be verified. Make sure this URL contains a file of nonzero length.
  • Consent Needed: You must choose to show the Full Consent option if your site must share data with another party. For example, full consent is required if your site has a chat feature, if you require sharing data with an advertising resource, and so on. When selected, the parent will not be given the option to select limited consent.

See Also

Service Requirements