OESECTOOL utilities
- Last Updated: August 12, 2026
- 3 minute read
- OpenEdge
- Version 13.1
- Documentation
- List available commands.
- Generate a sample configuration command.
- Check port availability.
- Generate and parse tokens.
- Import and export certificates.
The utilities use this syntax:
|
Commands
- command
- The utility commands include:
| Command | Description |
|---|---|
| catalina_opts | Provides a command template for System Administrators to set the PAS for OpenEdge
instance truststore to the OESECTOOL-created truststore containing
self-signed certificates for testing purposes, when using HTTPS
requests.
|
| checkports | Checks port availability.
|
| certinfo | Displays the properties of one or more certificates.
Specify
a path to a PEM format file containing one or more certificates,
or specify |
| expcert | Exports a public key
certificate. |
| gencert | Generates a server-specific self-signed certificate from the OESECTOOL PEM file
without starting a SAML or OAuth2 server.
For
PAS for OpenEdge tests, set |
| genjwe | Generates a JWE token.
|
| genjws | Generates a JWS token.
|
| help | Provides a list of commands. |
| impcert | Imports a public key
certificate. |
| matchcert | Verifies that a certificate's public key pairs with a private key.
|
| parsejwe | Decrypts a JWE token to extract a JWS token and validates the JWS
signature. |
| parsejws | Parses and validates a JWS token.
|
parameter- The utility parameters include:
| Parameter | Description |
|---|---|
| -alias | Certificate alias |
| -askoverwrite | Optional. Asks whether to overwrite message, yes or no. The default value is
yes. |
| -cert certificatefilepath | Path to a certificate file |
| -encalg encryptionalgorithm | Encryption algorithm |
| -encalias encryptionkeyalias | The encryption key alias supplied by the PAS for OpenEdge System Administrator and added to the keystore. |
| -encmethod encryptionmethod | Encryption method |
| -jwe jwetokenfilepath | JWE token file path |
| -jws jwsfilepath | JWS token file path |
| -key privatekeyfilepath | Path to a PEM format file containing a single private key. Used with the
matchcert command. |
| -keystore keystorefilepath | Path to keystore file |
| -payload jsonpayloadfilepath | Payload JSON file path |
| -pem pemfilepath | Path to a PEM format file containing a private key and a certificate template. Used
with the gencert command. For PAS for OpenEdge
tests, use
oesectool-dir/conf/oesectool.pem. |
| -port portnumber | Port number for HTTP requests |
| -ports portnumber | Port number for HTTPS requests |
| -sigalias signaturekeyalias | Signature key alias |
| -sigalg signaturealgorithm | Signature algorithm |
Import certificates
|
Export certificates
To export a public key certificate, use:
|
|
Creating keys and certificates
For more information about creating keys and certificates, see Manage OpenEdge Keys and Certificates.
Generate a JWS token example
To generate a JWS token, use:
|
jwsToken file is:
|
For more details on the payload required by this command, see Sample Payload for OAuth2.
Generate a JWE token example
To generate a JWE token, use:
|
jweToken file is:
|
Sample Payload
|
Parse a JWE token
|
The output is:
|
Parse a JWS token
To parse and validate a JWS token, use:
|
|
Display certificate information
To display the properties of certificates in a PEM file, use:
|
The output includes the certificate issuer, server names, validity dates, and signature algorithm. Example:
|
To display certificates from the Windows ROOT certificate store, use:
|
Generate a server certificate
To generate a server certificate for PASOE tests without starting a server, use:
|
OESECTOOL reads the private key and certificate template from conf/oesectool.pem and generates a new certificate issued for the current server. The output file work/oesectool.0 can then be added to the OS Trust Store for use in testing.
gencert
when you want to pre-load the certificate into the OS Trust Store before running
a test.Verify a certificate and private key pair
To verify that a certificate's public key matches a private key, use:
|
If the certificate matches the private key, the output is:
|
If the certificate does not match the private key, the output is:
|