From Bright Pattern Documentation
(Created new topic from branched topic Documentation:PartnerDocs:saml2-single-sign-on-integration-guide:InstallForgeRockonaWindowsMachine:5.1) |
(Updated via BpDeleteTranslateTags script) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
| − | + | = Install ForgeRock on a Windows Machine= | |
This section of the ''SAML 2.0 Single Sign-On Integration Guide'' explains how to install ForgeRock (OpenAm) on a Windows Machine. | This section of the ''SAML 2.0 Single Sign-On Integration Guide'' explains how to install ForgeRock (OpenAm) on a Windows Machine. | ||
| Line 7: | Line 7: | ||
| − | == Configuration == | + | == Configuration == |
| − | + | === Step 1: Get Java === | |
| − | + | Download and install the latest Java [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html JRE] or [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html JDK]. | |
| + | |||
| + | Tomcat (see Step 2 of configuration) uses Java Runtime Environment (JRE) and is a part of Java Development Kit (JDK). JDK is used for the development of the Java app. Either JRE or JDK will work. | ||
| + | |||
| + | === Step 2: Get Tomcat === | ||
| + | Download and install [http://apache.mirrors.ionfish.org/tomcat/tomcat-9/v9.0.7/bin/apache-tomcat-9.0.7-windows-x64.zip Tomcat 9.0]. | ||
| + | |||
| + | === Step 3: Get OpenAm === | ||
# Download [https://backstage.forgerock.com/get/am/am/am-zip/5.5.1/ OpenAm distributive].<br /><br /> | # Download [https://backstage.forgerock.com/get/am/am/am-zip/5.5.1/ OpenAm distributive].<br /><br /> | ||
| − | + | # Unzip the file.<br /><br /> | |
| − | + | # Find the file with the ''.war'' extension, which has a name similar to ''AM-5.x.x. Eval''.<br /><br /> | |
| − | + | # Rename the file ''openam''. | |
| − | + | ||
| + | === Step 4: Verify that Tomcat is running === | ||
| + | Check it in the Windows Services option. | ||
| + | |||
| + | === Step 5: Create ForgeRock directory === | ||
# Copy the ''openam.war'' file to your computer in ''/Program Files/Apache Software Foundation/Tomcat 9.0/webapps''.<br /><br /> | # Copy the ''openam.war'' file to your computer in ''/Program Files/Apache Software Foundation/Tomcat 9.0/webapps''.<br /><br /> | ||
| − | # Wait until Tomcat creates the directory "openam" | + | # Wait until Tomcat creates the directory "openam" |
| + | |||
| + | === Step Q: Create default configuration === | ||
# Go to ''http://<FQDN>:8080/openam''<br /><br /> | # Go to ''http://<FQDN>:8080/openam''<br /><br /> | ||
| − | + | # Set the password for "amadmin".<br /><br /> | |
| − | + | # Wait until the configuration is created.<br /><br /> | |
| − | |||
# Go to ''http://<FQDN>:8080/openam/XUI/#login/'' and then enter the login and password for "amadmin" user.<br /><br /> | # Go to ''http://<FQDN>:8080/openam/XUI/#login/'' and then enter the login and password for "amadmin" user.<br /><br /> | ||
# Create a user in the ''Top Level Realms > Subjects'' section (i.e., user1:password). | # Create a user in the ''Top Level Realms > Subjects'' section (i.e., user1:password). | ||
| Line 26: | Line 38: | ||
In the sections that follow, you will learn how to create an Identity Provider (IdP) at your ForgeRock Instance, which involves creating a hosted identity provider, enabling SAML 2.0, adding the entity provider, and changing your NameID service options. These steps need to be followed before you can configure Bright Pattern to use ForgeRock single sign-on. | In the sections that follow, you will learn how to create an Identity Provider (IdP) at your ForgeRock Instance, which involves creating a hosted identity provider, enabling SAML 2.0, adding the entity provider, and changing your NameID service options. These steps need to be followed before you can configure Bright Pattern to use ForgeRock single sign-on. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Latest revision as of 04:32, 29 May 2024
Install ForgeRock on a Windows Machine
This section of the SAML 2.0 Single Sign-On Integration Guide explains how to install ForgeRock (OpenAm) on a Windows Machine.
Prerequisites
The Windows machine must have a fully qualified domain name (FQDN).
Configuration
Step 1: Get Java
Download and install the latest Java JRE or JDK.
Tomcat (see Step 2 of configuration) uses Java Runtime Environment (JRE) and is a part of Java Development Kit (JDK). JDK is used for the development of the Java app. Either JRE or JDK will work.
Step 2: Get Tomcat
Download and install Tomcat 9.0.
Step 3: Get OpenAm
- Download OpenAm distributive.
- Unzip the file.
- Find the file with the .war extension, which has a name similar to AM-5.x.x. Eval.
- Rename the file openam.
Step 4: Verify that Tomcat is running
Check it in the Windows Services option.
Step 5: Create ForgeRock directory
- Copy the openam.war file to your computer in /Program Files/Apache Software Foundation/Tomcat 9.0/webapps.
- Wait until Tomcat creates the directory "openam"
Step Q: Create default configuration
- Go to http://<FQDN>:8080/openam
- Set the password for "amadmin".
- Wait until the configuration is created.
- Go to http://<FQDN>:8080/openam/XUI/#login/ and then enter the login and password for "amadmin" user.
- Create a user in the Top Level Realms > Subjects section (i.e., user1:password).
In the sections that follow, you will learn how to create an Identity Provider (IdP) at your ForgeRock Instance, which involves creating a hosted identity provider, enabling SAML 2.0, adding the entity provider, and changing your NameID service options. These steps need to be followed before you can configure Bright Pattern to use ForgeRock single sign-on.