Resources For IT Professionals
Post an article
Wikis - Page Details
  • First published by (6MVP, Microsoft Partne)
  • When: 21 Jan 2012 3:17 AM
  • Last revision by (cMVP, Microsoft Community Contributo)
  • When: 3 Sep 2013 2:57 PM
  • Revisions: 27
  • Comments: 25
Options
RSSSubscribe to Article (RSS)
Can You Improve This Article?
Positively! Click Sign In to add the tip, solution, correction or comment that will help other users.

Report inappropriate content using these instructions.
Wiki  >  TechNet Articles  >  BizTalk Server 2010: Enterprise SSO Survival Guide

BizTalk Server 2010: Enterprise SSO Survival Guide

BizTalk Server 2010: Enterprise SSO Survival Guide

Table of Contents


Introduction

Enterprise Single Sign-On (ESSO) is an important component of BizTalk Server. ESSO is responsible for securely storing critical information such as secure configuration properties  for the BizTalk adapters. On each computer where BizTalk runtime is installed the ESSO is present. Typically ENTSSO is installed to: C:\Program Files\Common Files\Enterprise Single Sign-On. This article will provide you with the necessary information on ESSO, how to manage and troubleshoot it.

Managing Enterprise Single Sign-On

You can manage the ESSO using two command line tools:
  • SSOManage
  • SSOConfig

These tools can be found in the directory C:\Program Files\Common Files\Enterprise Single Sign-On.

SSOConfig

SSOConfig Commandline commands:

Command
 Description
 -setDB  set SQL Server and SSO database names
 -showDB  show the SQL Server and SSO database names
 -createDB  create SSO database
 -upgradeDB  upgrade SSO database
 -generateSecret  generate new SSO master secret
 -backupSecret  backup current SSO master secret
 -restoreSecret
 restore SSO master secret
 -auditLevel  set SSO server audit level (see below)
 -setSSL  set SSL encryption
 -replayFiles  set directory for replay files
 -syncAge  set maximum password age (for password sync)
 -remoteLookup
 allow remote lookup of credentials
 -discover  discover SSO servers
 -status  display SSO server status
 -allowPS  allow password sync (from PCNS or MIIS)
 -reportFilterErrors  report password filter errors (at runtime)
 -scp  Service Connection Points (SCP)

 

Audit Level

There are two audit level settings – the “positive” audit level, which controls audits of things that succeed, and the “negative” audit level, which controls audits of things that fail. The possible values for the audit levels are:

  • 0 = off
  • 1 = low
  • 2 = medium
  • 3 = high
Examples:
ssoconfig -auditlevel
Reports the current audit level

ssoconfig -auditlevel 0 3
Does not report successes; reports high/verbose for failures

ssoconfig -auditlevel 1 1
Reports low for both successes and failures

SSOManage

SSOMange Commandline commands:

Configuration functions

Command
Description
 -server  set SSO server name (for current user)
 -serverall set SSO server name (for all users)
 -showserver show the SSO server name(s)

 

Administration functions

 Command Description
 -updatedb  update SSO database
 -enablesso  enable SSO
 -disablesso  disable SSO
 -tickets  control SSO ticket behavior
 -enable  enable SSO features
 -disable  disable SSO features
 -displaydb  display current SSO database settings

Application functions

 Command Description
 -listapps  list existing applications
 -displayapp  display application information
 -createapps  create new applications
 -deleteapp  delete an existing application
 -updateapps  update existing applications
 -enableapp  enable application
 -disableapp  disable application
 -purgecache  purge the credential cache for an application

Mapping functions

Command
Description
 -listmappings  list mappings for a user
 -createmappings  create mappings for users
 -deletemappings  delete mappings for users
 -enablemapping  enable a single mapping for a user
 -disablemapping  disable a single mapping for a user
 -deletemapping  delete a single mapping for a user
 -setcredentials  set external credentials for a user

Troubleshooting

There is a document that can aid you in troubleshooting BizTalk Server 2010 Setup and MSDN page Troubleshooting Enterprise Single Sign-On. For troubleshooting it is best to turn both audit levels to high:  ssoconfig –auditlevel 3 3.

In case your problem is reproducible, set both the audit levels to high, clear the event log, wait for 1 minute or restart the ENTSSO service (to make sure the ENTSSO service picks up the new audit levels), and try the repro scenario. Take a look in the event log after the reproduction of the problem.

See Also

Another important place to find a huge amount of BizTalk related articles is the TechNet Wiki itself. The best entry point is BizTalk Server Resources on the TechNet Wiki.

Read suggested related topics:

, , , , , , , , , , , , [Edit tags]
Leave a Comment
  • Please add 7 and 3 and type the answer here:
  • Post
Wiki - Revision Comment List(Revision Comment)
Sort by: Published Date | Most Recent | Most Useful
Comments
  • 6 Aug 2013 3:34 AM

    Steef-Jan Wiggers edited Revision 23. Comment: Minor edit

  • 23 May 2013 1:06 AM

    Carsten Siemens edited Revision 21. Comment: Added tag: "has TOC"

  • 8 May 2013 3:27 PM

    Randy Ridgely [MSFT] edited Revision 20. Comment: As the commenter noted, the options for the commands were reversed -- SSOManage options under SSOConfig and vice versa. Corrected. Also added examples for audit level.

  • 10 Feb 2012 2:28 PM

    Steef-Jan Wiggers edited Revision 17. Comment: Formatting

  • 7 Feb 2012 11:38 AM

    Steef-Jan Wiggers edited Revision 16. Comment: Added link

  • 6 Feb 2012 10:58 AM

    Steef-Jan Wiggers edited Revision 15. Comment: Added resource link

  • 21 Jan 2012 4:17 AM

    Steef-Jan Wiggers edited Revision 14. Comment: Added text

  • 21 Jan 2012 4:10 AM

    Steef-Jan Wiggers edited Revision 13. Comment: Added text

  • 21 Jan 2012 4:08 AM

    Steef-Jan Wiggers edited Revision 12. Comment: Added resource link

  • 21 Jan 2012 4:05 AM

    Steef-Jan Wiggers edited Revision 11. Comment: Added text

Page 1 of 3 (21 items) 123
Wikis - Comment List
Sort by: Published Date | Most Recent | Most Useful
Posting comments is temporarily disabled until 10:00am PST on Saturday, December 14th. Thank you for your patience.
Comments
  • Posted by
    on 12 Aug 2013 8:15 AM

    Nice guide!

  • Posted by
    on 6 Aug 2013 3:34 AM

    Steef-Jan Wiggers edited Revision 23. Comment: Minor edit

  • Posted by
    on 23 May 2013 1:06 AM

    Carsten Siemens edited Revision 21. Comment: Added tag: "has TOC"

  • Posted by
    on 9 May 2013 11:08 AM

    BizTron, I've reversed the layout. The options should now align with the correct executable. Thanks!

  • Posted by
    on 8 May 2013 3:27 PM

    Randy Ridgely [MSFT] edited Revision 20. Comment: As the commenter noted, the options for the commands were reversed -- SSOManage options under SSOConfig and vice versa. Corrected. Also added examples for audit level.

  • Posted by
    on 7 Jan 2013 12:56 PM

    The Command Line options for these is reversed.  Try "SSOManage -showDB", then try "SSOConfig -showDB".

    > SSOManage -?

    > SSOConfig -?

    This was confusing the first several times I found this site, but I only just now verified why I was confused.

  • Posted by
    on 10 Feb 2012 2:28 PM

    Steef-Jan Wiggers edited Revision 17. Comment: Formatting

  • Posted by
    on 7 Feb 2012 11:38 AM

    Steef-Jan Wiggers edited Revision 16. Comment: Added link

  • Posted by
    on 6 Feb 2012 10:58 AM

    Steef-Jan Wiggers edited Revision 15. Comment: Added resource link

  • Posted by
    on 23 Jan 2012 4:59 AM

    I've been looking for a simple guide like this, Thank you!

  • Posted by
    on 21 Jan 2012 4:17 AM

    Steef-Jan Wiggers edited Revision 14. Comment: Added text

  • Posted by
    on 21 Jan 2012 4:10 AM

    Steef-Jan Wiggers edited Revision 13. Comment: Added text

  • Posted by
    on 21 Jan 2012 4:08 AM

    Steef-Jan Wiggers edited Revision 12. Comment: Added resource link

  • Posted by
    on 21 Jan 2012 4:05 AM

    Steef-Jan Wiggers edited Revision 11. Comment: Added text

  • Posted by
    on 21 Jan 2012 4:03 AM

    Steef-Jan Wiggers edited Revision 10. Comment: Added text to table

Page 1 of 2 (25 items) 12