Package   Class  Use  Tree  Deprecated  Index  Help 
Oracle
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

com.bea.security.saml2.providers
Interface SAML2SPPartnerRegistryMBean

All Superinterfaces:
weblogic.management.utils.ListerMBean, weblogic.management.utils.NameListerMBean, weblogic.management.security.ProviderMBean, SAML2PartnerRegistryMBean
All Known Subinterfaces:
SAML2CredentialMapperMBean
public interface SAML2SPPartnerRegistryMBean
extends SAML2PartnerRegistryMBean

The SAML2SPPartnerRegistry is used manage a registry of SAML 2.0 SP partners.

 

Deprecation of MBeanHome and Type-Safe Interfaces

This is a type-safe interface for a WebLogic Server MBean, which you can import into your client classes and access through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, client classes that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime. For more information, see "Developing Manageable Applications with JMX" on http://edocs.bea.com.

Method Summary
 void addSPPartner(com.bea.security.saml2.providers.registry.SPPartner spPartner)
          Adds a new SP partner to the registry.
 com.bea.security.saml2.providers.registry.MetadataPartner consumeSPPartnerMetadata(String fileName)
          Returns an imported SP partner object.
 String getName()
          The name of this configuration.
 com.bea.security.saml2.providers.registry.SPPartner getSPPartner(String partnerName)
          Gets the SP partner corresponding to a partnerName.
 String listSPPartners(String partnerNameWildcard, int maxToReturn)
          Lists the registered partner names that match a wild card.
 com.bea.security.saml2.providers.registry.Endpoint newEndpoint()
          Returns a new Endpoint object.
 com.bea.security.saml2.providers.registry.IndexedEndpoint newIndexedEndpoint()
          Returns a new IndexedEndpoint object.
 com.bea.security.saml2.providers.registry.WebSSOSPPartner newWebSSOSPPartner()
          Returns a new Web SSO profile SP partner object.
 com.bea.security.saml2.providers.registry.WSSSPPartner newWSSSPPartner()
          Returns a new WSS token profile SP partner object.
 void removeSPPartner(String partnerName)
          Removes a SP partner from the registry.
 boolean spPartnerExists(String partnerName)
          Determines whether or not a SP partner exists for the given partner name.
 void updateSPPartner(com.bea.security.saml2.providers.registry.SPPartner spPartner)
          Updates a SP partner in the registry.
 
Methods inherited from interface com.bea.security.saml2.providers.SAML2PartnerRegistryMBean
loadCertificate
 
Methods inherited from interface weblogic.management.security.ProviderMBean
getDescription, getRealm, getVersion
 
Methods inherited from interface weblogic.management.utils.NameListerMBean
getCurrentName
 
Methods inherited from interface weblogic.management.utils.ListerMBean
advance, close, haveCurrent
 

Method Detail

listSPPartners

String listSPPartners(String partnerNameWildcard,
                      int maxToReturn)
                      throws weblogic.management.utils.InvalidCursorException,
                             weblogic.management.utils.InvalidParameterException

Lists the registered partner names that match a wild card. <p> It follows the NameListerMBean cursor pattern. The results are not sorted. <p> Returns a String containing a cursor that may be passed into the NameListerMBean methods to read the list. The getCurrentName method returns the current alias on the list. <p> Throws InvalidParameterException if partnerNameWildcard is empty or null or if maxToReturn is less than zero.

Lists the registered partner names that match a wild card. <p> It follows the NameListerMBean cursor pattern. The results are not sorted. <p> Returns a String containing a cursor that may be passed into the NameListerMBean methods to read the list. The getCurrentName method returns the current alias on the list. <p> Throws InvalidParameterException if partnerNameWildcard is empty or null or if maxToReturn is less than zero.

Parameters:
partnerNameWildcard - - A wild card used to select partner names. It supports three formats: "*" matches all partner names. "foo*" matches all partner names starting with the string "foo". "foo" matches the partner name "foo" only. The matches are case-insensitive.
maxToReturn - - The maximum number of partner names this method may return. If there are more matches than this maximum, then the returned results are arbitrary because this method does not sort the results. Set this parameter to zero to return all matching aliases.
Throws:
weblogic.management.utils.InvalidCursorException
weblogic.management.utils.InvalidParameterException

spPartnerExists

boolean spPartnerExists(String partnerName)
                        throws weblogic.management.utils.InvalidParameterException

Determines whether or not a SP partner exists for the given partner name. <p> Returns true if the partner is found, false if not. <p> Throws InvalidParameterException if partnerId is empty or null.

Parameters:
partnerName - - The partnerName of the SP partner.
Throws:
weblogic.management.utils.InvalidParameterException

getSPPartner

com.bea.security.saml2.providers.registry.SPPartner getSPPartner(String partnerName)
                                                                 throws weblogic.management.utils.NotFoundException,
                                                                        weblogic.management.utils.InvalidParameterException

Gets the SP partner corresponding to a partnerName. <p> Throws NotFoundException if the partner is not found. Throws InvalidParameterException if partnerName is empty or null.

Parameters:
partnerName - - The partnerName of the SP partner to return.
Throws:
weblogic.management.utils.NotFoundException
weblogic.management.utils.InvalidParameterException

addSPPartner

void addSPPartner(com.bea.security.saml2.providers.registry.SPPartner spPartner)
                  throws weblogic.management.utils.InvalidParameterException,
                         weblogic.management.utils.AlreadyExistsException,
                         weblogic.management.utils.CreateException

Adds a new SP partner to the registry. <p> Throws InvalidParameterException if the partner object fails validation. Throws CreateException if an error occurs during creation of the object.

Parameters:
spPartner - - The new SP partner to add.
Throws:
weblogic.management.utils.InvalidParameterException
weblogic.management.utils.AlreadyExistsException
weblogic.management.utils.CreateException

updateSPPartner

void updateSPPartner(com.bea.security.saml2.providers.registry.SPPartner spPartner)
                     throws weblogic.management.utils.NotFoundException,
                            weblogic.management.utils.InvalidParameterException

Updates a SP partner in the registry. <p> Throws NotFoundException if the partner does not exist. Throws InvalidParameterException if the partner object fails validation.

Parameters:
spPartner - - The relying party to update.
Throws:
weblogic.management.utils.NotFoundException
weblogic.management.utils.InvalidParameterException

removeSPPartner

void removeSPPartner(String partnerName)
                     throws weblogic.management.utils.NotFoundException,
                            weblogic.management.utils.InvalidParameterException

Removes a SP partner from the registry. <p> Throws NotFoundException if the partner does not exist. Throws InvalidParameterException if the partnerName is empty or null.

Parameters:
partnerName - - The partnerName of the SP partner to remove.
Throws:
weblogic.management.utils.NotFoundException
weblogic.management.utils.InvalidParameterException

newWebSSOSPPartner

com.bea.security.saml2.providers.registry.WebSSOSPPartner newWebSSOSPPartner()

Returns a new Web SSO profile SP partner object. Caller can set the fields of this object and then call addSPPartner() to add the new partner to the registry. <p> SP partner objects obtained from this method should not be passed to updateSPPartner() -- call getSPPartner() to fetch an existing partner for update.

Returns a new Web SSO profile SP partner object. Caller can set the fields of this object and then call addSPPartner() to add the new partner to the registry. <p> SP partner objects obtained from this method should not be passed to updateSPPartner() -- call getSPPartner() to fetch an existing partner for update.

newWSSSPPartner

com.bea.security.saml2.providers.registry.WSSSPPartner newWSSSPPartner()

Returns a new WSS token profile SP partner object. Caller can set the fields of this object and then call addSPPartner() to add the new partner to the registry. <p> SP partner objects obtained from this method should not be passed to updateSPPartner() -- call getSPPartner() to fetch an existing partner for update.

newEndpoint

com.bea.security.saml2.providers.registry.Endpoint newEndpoint()

Returns a new Endpoint object.

newIndexedEndpoint

com.bea.security.saml2.providers.registry.IndexedEndpoint newIndexedEndpoint()

Returns a new IndexedEndpoint object.

consumeSPPartnerMetadata

com.bea.security.saml2.providers.registry.MetadataPartner consumeSPPartnerMetadata(String fileName)
                                                                                   throws weblogic.management.utils.CreateException,
                                                                                          weblogic.management.utils.InvalidParameterException

Returns an imported SP partner object. Caller can set the fields of this object and then call addIdPPartner() to add the new partner to the registry.

Parameters:
fileName - - The file name containing the partner meta-data to consume.
Throws:
weblogic.management.utils.CreateException
weblogic.management.utils.InvalidParameterException

getName

String getName()
Description copied from interface: weblogic.management.security.ProviderMBean
Name of configuration. WebLogic Server uses an MBean to implement and persist the configuration.

Specified by:
getName in interface weblogic.management.security.ProviderMBean
Specified by:
getName in interface SAML2PartnerRegistryMBean
Default Value:
"SAML2SPPartnerRegistry"
Package   Class  Use  Tree  Deprecated  Index  Help 
Documentation is available at
http://edocs.bea.com/wls/docs103
Copyright 1996,2008, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD