Public class SAMLAssertions {
// SAML service provider
// Change it to the SAML service provider url that you are
// trying to connect to
static final String SERVICE_URL =
      "https://pilotpts.verisign.com/vspts/SamlResponder";
// Email of the subject that uniquely identifies it
static final String SUBJECT_EMAIL = "jdoe@tpms.verisign.com";
// Subject password to authenticate the user 
static final String SUBJECT_PASSWORD = "password";
// The keystore to be used for getting the private key and
// the public key
static final String KEYSTORE_FILE = "saml_sample_keystore";
// Keystore password
static final String STORE_PASS = "changeit";
static final String SIGNER_ALIAS = "pilot_saml_signer";
// VeriSign attribute naming constants
static final String V_NAME_QUALIFIER = "verisign.com/ams";
static final String V_ATTR_NAMESPACE =
      "verisign.com/ams/namespace/common";
static final String V_ATTR_EMAIL =
      "//verisign.com/core/attr/email";
static final String V_ATTR_FIRSTNAME =
      "//verisign.com/core/attr/first_name";
public static void main(String arg[]) {
NameIdentifier nameId = 
      new NameIdentifier(SUBJECT_EMAIL, V_NAME_QUALIFIER, "");
String[] confMethods = { Identifiers.AUTHN_METHOD_PASSWORD }; 
SubjectConfirmation sconf =
      new SubjectConfirmation(confMethods, SUBJECT_PASSWORD);
Subject subject = new Subject(nameId, sconf);
AttributeDesignator[] reqAttrs = null;
AttributeQuery query = new AttributeQuery(subject, reqAttrs);
AttributeStatementProvider provider = null;
try { 
provider = getAttributeStatementProvider();
} catch (Exception e) { 
// XXX Auto-generated catch block
e.printStackTrace();
}
AttributeStatement[] statements = null;
try { 
statements = provider.processAttributeQuery(query);
} catch (Exception e1) {
// XXX Auto-generated catch block
e1.printStackTrace();
}
if (statements.length == 0) {
System.out.println("No statements returned");
}
for (int i = 0; i < statements.length; i += 1) { 
AttributeStatement statement = statements[i];
Authenticity authenticity = statement.getAuthenticity();
System.out.println( "Statement "+ (i + 1)+ " authenticity: "
      + authenticity.isAuthentic());
// Print attribute statement 
System.out.println("--- Attribute Statement ---");
System.out.println(  "  Subject: "
      + statement.getSubject().getNameIdentifier().getValue())
// Print attribute values
Attribute[] attrs = statement.getAttributes();
for (int k = 0; k < attrs.length; k += 1) {
Attribute attr = attrs[k];
System.out.println(  "Namespace: " + attr.getAttributeNamespace());
System.out.println(" Name: " + attr.getAttributeName()); 
Object[] values = attr.getAttributeValues();
for (int m = 0; m < values.length; m += 1) { 
System.out.println( " Value: " + values[m].toString());
}
}
}
}
private static AttributeStatementProvider
getAttributeStatementProvider() throws Exception {
// Read the keystore and get the signing cert/key.
InputStream fileInput = new FileInputStream(KEYSTORE_FILE);
KeyStore keystore =
      KeyStore.getInstance(KeyStore.getDefaultType());
keystore.load(fileInput,STORE_PASS.toCharArray());
PrivateKey key =
      (PrivateKey) keystore.getKey(
            SIGNER_ALIAS,STORE_PASS.toCharArray());
if (key == null) {
throw new Exception(SIGNER_ALIAS +
      " key not found in keystore " + KEYSTORE_FILE);
}
Certificate[] certArray =
      keystore.getCertificateChain(SIGNER_ALIAS);
if (certArray == null) {
throw new Exception(SIGNER_ALIAS +
      " cert not found in keystore " + KEYSTORE_FILE);
}
X509Certificate[] certs = new X509Certificate[certArray.length];
System.arraycopy(certArray, 0, certs, 0, certs.length);
// Create SOAP assertion provider factory with signing information
SOAPAssertionProviderFactory factory =
      new SOAPAssertionProviderFactory(new URL(SERVICE_URL));
factory.setSigningKey(new RSASigningKey(key));
factory.setVerifyingKey(new RSAVerifyingKey(certs));
return factory.newAttributeStatementProvider(); }
}
清单 1 中在 SOAP 协议上查询主体属性的步骤描述如下：
• 第 1 步： 建立关心其属性的主体。这是通过创建 SubjectIdentifier 并定义 SubjectConfirmation 方法实现的。
• 第 2 步： 使用主体的 e-mail ID 作为主体的唯一标识符。
• 第 3 步： 指定验证用户所使用的方法。清单 1 中使用的是口令验证。
• 第 4 步：创建 AttributeDesignator 对象，该对象指定了希望检索的属性。在清单 1 中，Verisign 的 SAML 实现把这个数组保留为空值，检索与查询对象相关的所有属性值，这些属性在 AttributeDesignator 数组中指定。
• 第 5 步：使用主体和 AttributeDesignator 数组创建 AttributeQuery 对象。
• 第 6 步：使用密钥存储和示例 SAML 服务所运行的服务 URL 创建 AttributeStatementProvider。
• 第 7 步：使用 SOAPAssertionProviderFactory 创建 AttributeStatementProvider。在创建 AttributeStatementProvider 之前必须向 SOAPAssertionProviderFactory 提供签名密钥和检验密钥。签名密钥是主体的私钥，检验密钥带有附加的证书。
• 第 8 步：对第 6 步创建的 AttributeStatementProvider 执行第 5 步建立的查询。获得一个 AttributeStatement 对象数组。该数组包含提供程序作为查询结果发送的所有属性的值。迭代陈述中的所有属性以便获得属性值。
结束语
本文考察了 SAML 的目标、体系结构和基本概念。SAML 完成了几件事情，澄清了安全可移植性领域的一些混乱：它定义了表示需要交换的信息的标准机制，定义了交换这类信息的标准。如果您迫切需要提供安全可移植性，您就不能不考虑基于这一计划的安全可移植性产品并采用 SAML 作为标准。
参考资料
• 下载本文所用的源代码。
• 阅读 OASIS 安全性断言标记语言（Security Assertion Markup Language）的 Assertions and Protocol（PDF 文件）。
• 阅读 OASIS 安全性断言标记语言（Security Assertion Markup Language）的 Bindings and Profiles（PDF 文件）。
• 阅读 OASIS 安全性断言标记语言（Security Assertion Markup Language）的 Security and Privacy Considerations（PDF 文件）。
• 还可以阅读 OASIS 安全性断言标记语言（Security Assertion Markup Language）的 Conformance Program Specification（PDF 文件）。
• 进一步了解 OASIS 安全性断言标记语言（Security Assertion Markup Language）的 Glossary（PDF 文件）。
• 阅读 XML-Signature Syntax and Processing 规范。
• 在 developerWorks XML 专区可以找到更多 XML 资源。
• 在 developerWorks Developer Bookstore 可以找到各种关于 XML 的书籍。
• 了解如何才能成为一名 IBM 认证的 XML 及相关技术的开发人员。