Operating Systems: i5/OS
Personalize the table of contents and search results
CertificateRequestCommands command group of the AdminTask object
You can use the Jython or Jacl scripting languages to configure
security with the wsadmin tool. The commands and parameters in the CertificateRequestCommands
group can be used to create and manage certificate requests.
The CertificateRequestCommands command group for the AdminTask object includes
the following commands:
createCertificateRequest
The createCertificateRequest command creates a certificate request that is associated with a particular
key store.
Target object
None.
Required
parameters and return values
- -keyStoreName
-
The name that uniquely identifies the key store configuration object.
(String, required)
- -keyStoreScope
-
The scope name of the key store. (String, optional)
- -certificateAlias
-
The name that uniquely identifies the certificate request in a key store.
(String, required)
- -certificateV
-
The certificate version. (String, required)
- -certificateSize
-
(Integer, required)
- -certificateCommonName
-
(String, required)
- -certificateOrganization
-
(String, optional)
- -certificateOrganizationUnit
-
(String, optional)
- -certificateLocality
-
(String, optional)
- -certificateState
-
The state code for the certificate. (String, optional)
- -certificateZip
-
The zip code for the certificate. (String, optional)
- -certificateCountry
-
The country for the certificate. (String, optional)
- -certificateValidDays
-
The amount of time in days for which the certificate is valid. (Integer,
optional)
- -certificateRequestFilePath
-
The file location of the certificate request that can be sent to a certificate
authority. (String, required)
- Returns: The configuration object name of the key store object that you
created.
Examples
Batch mode example usage:
- Using Jacl:
$AdminTask createCertificateRequest {-keyStoreName testKeyStore
-certificateAlias certReq -certificateSize 1024 -certificate
CommonName localhost -certificate Organization testing -certificate
RequestFilePath c:\temp\testCertReq.arm}
- Using Jython string:
AdminTask.createCertificateRequest ('[-keyStoreName testKeyStore
-certificateAlias certReq -certificateSize 1024 -certificate
CommonName localhost -certificate Organization testing -certificate
RequestFilePath c:\temp\testCertReq.arm]')
- Using Jython list:
AdminTask.createCertificateRequest (['-keyStoreName', 'testKeyStore',
'-certificateAlias', 'certReq', '-certificateSize', '1024',
'-certificateCommonName', 'localhost','-certificateOrganization',
'testing', '-certificateRequestFilePath','c:\temp\testCertReq.arm'])
Interactive mode example usage:
- Using Jacl:
$AdminTask createCertificateRequest {-interactive}
- Using Jython string:
AdminTask.createCertificateRequest ('[-interactive]')
- Using Jython list:
AdminTask.createCertificateRequest (['-interactive'])
deleteCertificateRequest
The deleteCertificateRequest command deletes a certificate request from a key store.
Target
object
None.
Required parameters and return
values
- -keyStoreName
-
The name that uniquely identifies the key store configuration object.
(String, required)
- -keyStoreScope
-
The scope name of the key store. (String, optional)
- -certificateAlias
-
The name that uniquely identifies the certificate request in a key store.
(String, required)
Examples
Interactive mode example
usage:
- Using Jacl:
$AdminTask deleteCertificateRequest {-interactive}
- Using Jython string:
AdminTask.deleteCertificateRequest ('[-interactive]')
- Using Jython list:
AdminTask.deleteCertificateRequest (['-interactive'])
extractCertificateRequest
The extractCertificateRequestcommand extracts a certificate request to a file.
Target
object
None.
Required parameters and return
values
- -keyStoreName
-
The name that uniquely identifies the key store configuration object.
(String, required)
- -keyStoreScope
-
The scope name of the key store. (String, optional)
- -certificateAlias
-
The name that uniquely identifies the certificate request in a key store.
(String, required)
- -certificateRequestFilePath
-
The file location of the certificate request that can be sent to a certificate
authority. (String, required)
- Returns: A certificate request file is created that contains the extracted
certificate.
Examples
Interactive mode example
usage:
- Using Jacl:
$AdminTask extractCertificateRequest {-interactive}
- Using Jython string:
AdminTask.extractCertificateRequest ('[-interactive]')
- Using Jython list:
AdminTask.extractCertificateRequest (['-interactive'])
getCertificateRequest
The getCertificateRequest command
obtains information about a particular certificate request in a key store.
Target object
None.
Required
parameters and return values
- -keyStoreName
-
The name that uniquely identifies the key store configuration object.
(String, required)
- -keyStoreScope
-
The scope name of the key store. (String, optional)
- -certificateAlias
-
The name that uniquely identifies the certificate request in a key store.
(String, required)
- Returns: Information about the certificate request.
Examples
Interactive mode example
usage:
- Using Jacl:
$AdminTask getCertificateRequest {-interactive}
- Using Jython string:
AdminTask.getCertificateRequest ('[-interactive]')
- Using Jython list:
AdminTask.getCertificateRequest (['-interactive'])
listCertificateRequest
The listCertificateRequest command lists all the certificate requests associated with a particular
key store.
Target object
None.
Required
parameters and return values
- -keyStoreName
-
The name that uniquely identifies the key store configuration object.
(String, required)
- -keyStoreScope
-
The scope name of the key store. (String, optional)
- Returns: An attribute list for each certificate request in a key store.
Examples
Interactive mode example
usage:
- Using Jacl:
$AdminTask listCertificateRequest {-interactive}
- Using Jython string:
AdminTask.listCertificateRequest ('[-interactive]')
- Using Jython list:
AdminTask.listCertificateRequest (['-interactive'])
Related tasks
Using the AdminTask object for scripted administration
Related Reference
Commands for the AdminTask object
Reference topic