Unpacking the Integration Bits

The opensso/integrations/oracle directory contains source and configurations to compile and build custom authentication modules and other plugins. See Chapter 3, Integrating Oracle Access Manager, in Sun OpenSSO Enterprise 8.0 Integration Guide for use case options and related information. The following table summarizes the files under opensso/integrations/oracle directory and descriptions for each file.

README.html

This is the file you're reading now.

build.xml

An ant build file for building a custom authentication module for Oracle Access Manager in OpenSSO

config

Configuration files required for creating an authentication module for Oracle Access Manager in OpenSSO.

• OblixAuthService.xml

  Authentication service file for Oracle Access Manager authentication module

• OblixAuthModule.xml

  Authentication module callbacks for Oracle Access Manager.

  This is an empty file by default, but it must be present for configuration purposes.

• OblixAuth.properties

  Properties file that stores internationalization keys for the authentication

lib

This directory is empty by default. This lib directory must contain the following libraries to compile the source libraries.

• jobaccess.jar

  Copy this file from the Oracle Access Manager SDK.

• openfedlib.jar, amserver.jar, and opensso-sharedlib.jar

  Copy these files from opensso.war

• servlet.jar or javaee.jar

  Copy the GlassFish lib directory. Ideally, any JAR file that has standard Java EE classes such as javax.servlet.http.Cookie is fine.

source

Directory containing the following source files:

• com/sun/identity/authentication/oblix/OblixAuthModule.java

• com/sun/identity/authentication/oblix/OblixAuthModule.java

• com/sun/identity/authentication/oblix/OblixPrincipal.java

• com/sun/identity/saml2/plugins/OAMAdapter.java

  This class is a SAML2 Plugin Adapter for SAML Service Providers. This class does the remote authentication to Oracle Access Manager using the OpenSSO Session service.

oamauth (optional)

This directory contains source files for Oblix Authentication Scheme for OpenSSO. This is a C-based authentication module and leverages the OpenSSO C-SDK for validation.

• oam/solaris/authn_api.c

  This file implements Oblix custom authentication scheme for OpenSSO.

• oam/solaris/include/*.h

  All the header files that are required to compile auth scheme.

• oam/solaris/AMAgent.properties

  Sample OpenSSO Agent configuration file. This is required for the authentication scheme to validate the OpenSSO session.