Create the Rapid or Classic EBS application
This topic describes how to create the Rapid or Classic EBS application.
Tasks
- Create the application
- Configure the EBS SSO Agent (Rapid) application
- Configure the EBS R12.1 or R12.2 (classic) application
Create the application
- Sign in to the Access Gateway Admin UI console.
- Click the Applications tab.
- Click +Add.
- Select one of Oracle EBS R12.1,Oracle EBS R12.2(for classic) or Oracle EBS SSO Agent(for rapid) from the left column menu, and click Create.
The steps that follow vary based on whether you are creating a Classic or Rapid EBS application.
Configure the EBS SSO Agent (Rapid) application
The following steps describe how to configure an EBS Rapid Application.
-
In the Essential pane enter:
Field Value Label The name of the application, as shown in your Okta tenant. Public Domain The externally facing URL of the EBS application. This must be the same value entered in step 7 of Enable Oracle E-Business Suite for single sign-on.
For example: https://ebs-external.example.com
Protected Web Resource The URL and port combination of the Oracle EBS Implementation being protected. Always end the protected resource URL with a forward slash (/). See Configure load balancing. For example: http://ebs-internal.example.com:8000/
Post Login URL URL of the EBS server.
This must be the hostname and port of the back-end EBS server and not the external name used in Public Domain. For example:
https://ebs-internal.example.com:8000/OA_HTML/OA.jsp?OAFunc=OAHOMEPAGE
Group The group containing users who can access the EBS instance. - See Certificate use for details about certificates.
- See Certificate management for a task flow for obtaining and assigning certificates.
- Expand the Certificates tab.
By default, when you create the app, the system generates a self-signed wildcard certificate and assigns it to the app.
- Optional. Click Generate self-signed certificate. A self-signed certificate is created and automatically assigned to the app.
- Optional. Select an existing certificate from the list. Use the Search field to narrow the set of certificates by common name. Use the page forward and backward arrows to navigate through the list.
-
Click Next.The Application Configuration pane displays.
-
In the Application configuration pane enter/verify:
Field Value EBS Service Account The EBS username from the configuration section. For example, OAGSSOUSER.
EBS Service Account Password Password associated with EBS Service Account. EBS User Identified Either USER_NAME or EMAIL_ADDRESS. DBC File Contents DBC file contents as provided by the Oracle EBS Administrator or the value from section Register Okta Access Gateway With Oracle E-Business Suite. - Click Not validated when complete.
If all values are entered correctly, the Not Validated button will change to Validated. - Click Next.
-
In the Attributes tab verify the following three attributes:
See Application attributes for detailed information on the attribute options.
Data Source Field Type Name IDP User profile field that represents the EBS user name. It can be data static and a fixed value for testing. EBS only supports user name values in upper case. Header EBS_USER static Auth Context Header REMOTE_IP static Auth Context Header SESSION_ID - Click Done when complete.
All apps, including the Access Gateway Admin UI console app, require a self-signed or signed certificate.
Include signed certificates wherever you terminate SSL. You can terminate SSL at Access Gateway or any other network component, like a load balancer.
If you terminate SSL at a load balancer, on the Access Gateway Admin UI console app, you also need to use a certificate that is trusted by the load balancer.
If you terminate SSL on the Access Gateway Admin UI console application, you must use a signed certificate, which must be on the Access Gateway node and be associated with the Access Gateway Admin UI console application.
Configure the EBS R12.1 or R12.2 (classic) application
The following steps describe how to create an EBS Classic application.
-
In the Essentials pane enter:
Field Value Label The name of the application as shown in your Okta tenant. Public Domain The externally facing URL of the EBS application.
For example, https://ebs-external.example.com
Protected Web Resource The URL and port combination of the Oracle EBS Implementation being protected. Always end the protected resource URL with a forward slash (/). See Configure load balancing.
For example, http://ebs-internal.example.com:8000/
Post Login URL Browseable route-through location to pick up the required EBS cookie from Okta Access Gateway and pass along to the Oracle EBS implementation.
For example, https://ebs-external.external/accessgate/dossologin
Group The group containing users who can access the EBS instance. - See Certificate use for details about certificates.
- See Certificate management for a task flow for obtaining and assigning certificates.
- Expand the Certificates tab.
By default, when you create the app, the system generates a self-signed wildcard certificate and assigns it to the app.
- Optional. Click Generate self-signed certificate. A self-signed certificate is created and automatically assigned to the app.
- Optional. Select an existing certificate from the list. Use the Search field to narrow the set of certificates by common name. Use the page forward and backward arrows to navigate through the list.
-
Click Next. The Application Configuration pane displays.
-
In the Application Configuration pane enter:
Field Value Access Gate URL The EBS URL matching the protected resource in the prior step using port 6801.
For example: http://ebs-accessgate.example.com:6801OID Datasource Enabled. OID Host Fully qualified host name of the OID Host.
For example: ebs-oid.example.comOID Port Port for the OID Host, typically 3060. User Search Attribute CN Matching Attribute EBSUSER, - Click Next when complete. The Attributes pane will display.
-
In the Attributes tab verify the following two attributes:
See Application attributes for detailed information on the attribute options.
Data Source Field Type Name IDP cn Header USER_NAME oid orclguid Header USER_ORCLGUID
All apps, including the Access Gateway Admin UI console app, require a self-signed or signed certificate.
Include signed certificates wherever you terminate SSL. You can terminate SSL at Access Gateway or any other network component, like a load balancer.
If you terminate SSL at a load balancer, on the Access Gateway Admin UI console app, you also need to use a certificate that is trusted by the load balancer.
If you terminate SSL on the Access Gateway Admin UI console application, you must use a signed certificate, which must be on the Access Gateway node and be associated with the Access Gateway Admin UI console application.
Configure load balancing
Only use Access Gateway as the load balancer. See Load balancing.
- Expand the Protected Web Resource tab.
- Enable Load Balancing By Access Gateway.
A table of hostnames and weights representing the target load balancing instances appears. This table is initially empty. Click edit to modify an entry in the table, or click delete to delete an entry.
- Choose either HTTP or HTTPS as the URL scheme. Each protected web resource that you add inherits this scheme.
- Optional. Enable and specify Host Header value.
- Complete the following steps to add a host, repeat as required:
- Click Add protected web resource.
- Enter a fully qualified hostname:port combination (for example, https://backendserver1.atko.com:7001).
- Enter a weight from 1 to 100. Enter 0 to specify that a host is disabled.
Weights represent the percentage of requests that will be routed to this host.
For example, two hosts of weights 2:1 would result in requests being routed ~66% to the host weighted 2 and ~33% to the host weighted 1.
- Click Okay.
-
Optional. Configure health checks, which use GET operations to confirm that back-end resources are functional.
New requests aren't routed to resources that have been labeled unhealthy by the health checks.
- Enable Load Balancer Health Check.
- Click Edit to modify health check settings.
- Modify settings as required.
Field Value Default
Path The URI path to the resource used in health check. / Method The HTTP method used. Always GET Status code The HTTP status code used to determine health. 200 Interval The interval between health checks in seconds. 10 Request timeout The health check request timeout in seconds. 1 Healthy threshold The number of requests that must succeed before a host is considered healthy. 3 Unhealthy threshold The number of requests that must fail before a host is considered unhealthy. 3 - Click Save to save changes or click Cancel to exit without saving.