Agent Guides › SAML Affiliate Agent Guide › Install a SAML Affiliate Agent › Perform the Initial Agent Configuration › Edit the AffiliateConfig.xml File

Edit the AffiliateConfig.xml File

The SAML Affiliate Agent Web server plug-in is configured through the AffiliateConfig.xml file. The initial configuration of this file ensures that the file reflects the correct settings to establish federated communication. All of these settings are in the PerAffiliateInfo section.

The AffiliateConfig.xml file resides in:

Windows: saml_affiliate_agent_home\config\

UNIX: saml_affiliate_agent_home/config/

The file defines elements and attributes in three sections—GlobalInfo, settings that apply for the consumer and producer, PerPortalInfo, settings that apply only to the producer, and PerAffiliateInfo, settings that apply only to the consumer.

Note: Restart the Web server after modifying the AffiliateConfig.xml file.

• AffiliateName

  Enter the name of the consumer as determined by the producer. For example:

  <AffiliateName>SampleConsumer</AffiliateName>

• AffiliatePassword

  The AffiliatePassword defines the encrypted password shared between the consumer and the producer. The password is used by the consumer to identify itself to the producer.

  <AffiliatePassword>cZQwIBUYl2xkn7IR4vkI2931bPuosh9U</AffiliatePassword>

  Important! The SAML Affiliate Agent is not compatible with the FIPS 140-2 encryption standards.

• AssertionAudience

  Enter the location of the document that describes the terms and conditions of the business agreement between the producer and the consumer. The audience is determined by the administrator at the producer.

  <AssertionAudience>http://www.netegrity.com/
  SampleAudience</AssertionAudience>

• AssertionIssuer

  Enter the URL that issues assertions for specific consumers. The consumer can accept assertions from only this issuer. For example,

  <AssertionIssuer>http://www.netegrity.com/
  SiteMinder</AssertionIssuer>

• AffiliateResource

  Enter a value against which the SAML Affiliate Agent compares each requested URL to determine if the consumer resource is protected. For example,

  <AffiliateResource MatchingRule="StrictPrefix">protected</AffiliaterResource>

• CompanySourceID

  Enter the producer’s source ID. This ID must match the source ID that the producer uses. For example,

  <CompanySourceID>b818452610a0ea431bff69dd346aeeff83128b6a</CompanySourceID>

• PortalName

  Enter the name of the producer site associated with the consumer. For example,

  <PortalName>SamplePortal</PortalName>

  Note: The name must match the name you enter for the portalName attribute in the PerPortalInfo section of the AffiliateConfig.xml file.