Downloading AM
The ForgeRock BackStage download site hosts downloads, including a .zip file with all of the AM components, the .war file, AM tools, the configurator, web and Java agents, Identity Gateway, and documentation. Review the Software License and Subscription Agreement presented before you download AM files.
For each release of AM, you can download the entire package as a .zip file, only the AM .war file, or only the administrative tools as a .zip archive. The Archives only have the AM source code used to build the release.
After you download the .zip file, create a new directory for AM, and unzip the .zip file to access the content.
$cd ~/Downloads$mkdir openam ; cd openam$unzip ~/Downloads/AM-7.0.2.zip
When you unzip the archive of the entire package, you get ldif, license, and legal directories in addition to the following files:
| File | Description |
|---|---|
AM-7.0.2.war | The distribution .war file includes the core server code with an embedded DS server. The distribution includes an administrative graphical user interface (GUI) Web console. During installation, the .war file accesses properties to obtain the fully qualified domain name, port, context path, and the location of the configuration folder. These properties can be obtained from the boot.json file in the AM installation directory, from environment variables, or from a combination of the two. This file is also available to download individually. |
AM-crypto-tool-7.0.2.war | AM provides a utility with some cryptographic functionality used for creating Docker images. This utility is strictly for future use, and is not currently supported. |
AM-Soap-STS-Server-7.0.2.war | AM provides a SOAP-based security token service (STS) server that issues tokens based on the WS-Security protocol[a]. |
AM-SSOAdminTools-5.1.3.11.zip | AM provides an ssoadm command-line tool that allows administrators to configure and maintain AM as well as create their own configuration scripts. The zip distribution file contains binaries, properties file, script templates, and setup scripts for UNIX and windows servers. |
AM-SSOConfiguratorTools-5.1.3.11.zip | AM provides configuration and upgrade tools for installing and maintaining your server. The zip distribution file contains libraries, legal notices, and supported binaries for these configuration tools. Also, you can view example configuration and upgrade properties files that can be used as a template for your deployments. |
Config-Upgrader-7.0.2.zip | AM provides a configuration file upgrade tool. For more information on converting configuration files for import into AM, see the README.md file in the Config-Upgrader-7.0.2.zip file. |
Fedlet-7.0.2.zip | AM provides an AM Fedlet, a light-weight SAML v2.0 service provider. The Fedlet lets you set up a federated deployment without the need of a fully-featured service provider. |
IDPDiscovery-7.0.2.war | AM provides an IDP Discovery Profile (SAMLv2 binding profile) for its IDP Discovery service. The profile keeps track of the identity providers for each user. |
sample-trees-7.0.2.zip | Clean installs of AM with an embedded data store provide ready-made sample authentication trees to demonstrate how they can be put together. These sample trees are not installed by default on installs of AM with an external configuration store, or if you are upgrading an existing instance of AM. The sample-trees-7.0.2.zip file contains the sample trees in JSON files, ready for import by Amster command-line interface. For information on importing files by using Amster, see Importing Configuration Data in the Amster 7 User Guide. |
Truststore-Utility-7.0.2.zip | AM provides a utility to help with creating a trust store for use with web authentication. See the readme.md in the ZIP file for instructions, and MFA: Web Authentication (WebAuthn) for more information. |
[a] AM also provides REST-based STS service endpoints, which you can directly utilize on the AM server. | |