Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
legal
openig-core
openig-doc
openig-oauth2
openig-openam
openig-saml
openig-uma
openig-war
src/site
.gitignore
README.md
pom.xml

README.md

OpenIG

The Open Identity Gateway (OpenIG) is a high-performance reverse proxy server with specialized session management and credential replay functionality.

OpenIG works together with OpenAM to integrate Web applications without the need to modify the target application or the container that it runs in.

  • Support for identity standards (OAuth 2.0, OpenID Connect, SAML 2.0)
  • Application and API gateway concept
  • Prepackaged SAML 2.0-based federation
  • Password capture and replay
  • Works with any identity provider, including OpenAM
  • Single Sign-On and Single Log-Out
  • 100% open source

Build and Run

You need git and maven in order to get the source code and build it:

git clone ssh://git@stash.forgerock.org:7999/openig/openig.git
cd openig
mvn clean install

Executing the OpenIG build is as simple as:

mvn -pl openig-war jetty:run

And you should see something like:

...
THU NOV 19 16:33:40 CET 2015 (INFO) _Router
Added route 'sts' defined in file '.../config/routes/openam-sts-oidc-to-saml.json'
------------------------------
...
Started ServerConnector@61843cc8{HTTP/1.1}{0.0.0.0:8080}
Started @10366ms
Started Jetty Server
Starting scanner at interval of 10 seconds.

The next step is then to go to http://localhost:8080 where you'll see the OpenIG welcome page.

Configure

If there was no OPENIG_BASE environment variable set, OpenIG uses ~/.openig as home where it loads its configuration files.

See the OpenIG guide for examples and detailed explanations.

Other online resources are available:

License

OpenIG is licensed under CDDL 1.0 (COMMON DEVELOPMENT AND DISTRIBUTION LICENSE Version 1.0)