Test OAuth2 configurations
- Last Updated: August 12, 2026
- 1 minute read
- OpenEdge
- Version 13.1
- Documentation
System Administrators use OESECTOOL to configure and start an OAuth2 test server for PAS for OpenEdge and OpenEdge Authentication Gateway servers. Testing is limited to checking for valid or invalid responses. Testing does not provide user login and session support.
Syntax
|
Parameters
- command
- The commands include:
| Command | Description |
|---|---|
| startoauth2server | Starts an OAuth2 test server.
Note: Using -port or -ports creates
a keystore.p12 file in
oesectool/work, if not already present.
Using -ports also creates an
sslkeystore.p12 file in
oesectool/work, if not already present.
In addition, starting the server generates
oesectool/work/oesectool.0, a PEM file
containing the server certificate. If your PAS for OpenEdge
instance uses the OS Trust Store, add this certificate to the OS
Trust Store before running tests. See OESECTOOL utilities. |
| stopoauth2server | Stops an OAuth2 test
server. |
parameters- The parameters include:
| Parameter | Description |
|---|---|
| -port portnumber | HTTP port number |
| -ports portnumber | HTTPS port number |
Customize OAuth2 test server properties
Before starting an OAuth2 test server, modify the oesectool/conf/oesectool-oauth2.properties file to configure an OAuth2 test server. For more information on oesectool-oauth2.properties, see the oesectool\conf\oesectool-oauth2.properties.README file.
Start an OAuth2 server
To start an OAuth2 server, use:
|
|
Set up the OS Trust Store for OESECTOOL testing
If your PAS for OpenEdge instance is configured to use the OS Trust Store, complete the following steps before running OAuth2 tests. This setup is required only once per server.
- Start the OESECTOOL OAuth2 server using the
-portsparameter to ensure the server certificate is generated:
OESECTOOL creates work/oesectool.0 containing the generated server certificate.oesectool startoauth2server -ports portnumber - Stop the server:
oesectool stopoauth2server -ports portnumber - Add the generated certificate to the OS Trust Store:
- On Linux: run install_certificates.sh.
- On Windows: run import-certificates.bat.
gencert
command to generate work/oesectool.0 without starting a server,
then add the certificate to the OS Trust Store. For more information, seeOESECTOOL utilities.Stop an OAuth2 server
To stop an OAuth2 server, use:
|
|