Operating Systems: i5/OS
Personalize the table of contents and search results
SignerCertificateCommands command group for 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 SignerCertificateCommands
group can be used to create and modify signer certificates in relation to
the key store file and to query for signer information on ports of remote
hosts.
The SignerCertificateCommands command group for the AdminTask object includes
the following commands:
deleteSignerCertificate
The deleteSignerCertificate command deletes a signer certificate from a key store.
Target
object
None
Required parameters and
return values
- -keyStoreName
-
The name of the key store where the signer certificate is located. (String,
required)
- -keyStoreScope
-
The management scope of the key store. (String, optional)
- -certificateAlias
-
The alias name of the signer certificate in the key store. (String, required)
Examples
Interactive
mode example usage:
- Using Jacl:
$AdminTask deleteSignerCertificate {-interactive}
- Using Jython string:
AdminTask.deleteSignerCertificate ('[-interactive]')
- Using Jython list:
AdminTask.deleteSignerCertificate (['-interactive'])
extractSignerCertificate
The extractSignerCertificate command extracts a signer certificate from a key store to a file.
Target object
None
Required
parameters and return values
- -keyStoreName
-
The name of the key store where the signer certificate is located. (String,
required)
- -keyStoreScope
-
The management scope of the key store. (String, optional)
- -certificateAlias
-
The alias name of the signer certificate in the key store. (String, required)
- -certificateFilePath
-
The full path name of the file that contains the signer certificate. (String,
required)
- -base64Encoded
-
Set the value of this parameter to true if the certificate is
ascii base 64 encoded. Set the value of this parameter to false if
the certificate is binary. (String, required)
Examples
Interactive
mode example usage:
- Using Jacl:
$AdminTask extractSignerCertificate {-interactive}
- Using Jython string:
AdminTask.extractSignerCertificate ('[-interactive]')
- Using Jython list:
AdminTask.extractSignerCertificate (['-interactive'])
getSignerCertificate
The getSignerCertificate command
obtains information about a signer certificate from a key store.
Target
object
None
Required parameters and
return values
- -keyStoreName
-
The name of the key store where the signer certificate is located. (String,
required)
- -keyStoreScope
-
The management scope of the key store. (String, optional)
- -certificateAlias
-
The alias name of the signer certificate in the key store. (String, required)
Examples
Interactive
mode example usage:
- Using Jacl:
$AdminTask getSignerCertificate {-interactive}
- Using Jython string:
AdminTask.getSignerCertificate ('[-interactive]')
- Using Jython list:
AdminTask.getSignerCertificate (['-interactive'])
listSignerCertificates
The listSignerCertificates command lists all signer certificates in a particular key store.
Target object
None
Required
parameters and return values
- -keyStoreName
-
The name of the key store where the signer certificate is located. (String,
required)
- -keyStoreScope
-
The management scope of the key store. (String, optional)
Examples
Interactive
mode example usage:
- Using Jacl:
$AdminTask listSignerCertificates {-interactive}
- Using Jython string:
AdminTask.listSignerCertificates ('[-interactive]')
- Using Jython list:
AdminTask.listSignerCertificates (['-interactive'])
retrieveSignerFromPort
The retrieveSignerFromPort command retrieves a signer from a remote host and stores the signer in a
key store.
Target object
None
Required parameters and return values
- -host
-
The host name of the system from where the signer certificate will be
retrieved. (String, required)
- -port
-
The port of the remote system from where the signer certificate will be
retrieved. (Integer, required)
- -keyStoreName
-
The name of the key store where the signer certificate is located. (String,
required)
- -keyStoreScope
-
The management scope of the key store. (String, required)
- -sslConfigName
-
The name of the SSL configuration object. (String, optional)
- -sslConfigScopeName
-
The management scope where the SSL configuration object is located. (String,
optional)
Examples
Batch mode
example usage:
- Using Jacl:
$AdminTask retrieveSignerFromPort {-host serverHost -port 443 -keyStoreName testKeyStore -certificateAlias serverHostSigner}
- Using Jython string:
AdminTask.retrieveSignerFromPort ('[-host serverHost -port 443 -keyStoreName testKeyStore -certificateAlias serverHostSigner]')
- Using Jython list:
AdminTask.retrieveSignerFromPort (['-host', 'serverHost', '-port', '443', '-keyStoreName', 'testKeyStore', '-certificateAlias', 'serverHostSigner'])
Interactive mode example usage:
- Using Jacl:
$AdminTask retrieveSignerFromPort {-interactive}
- Using Jython string:
AdminTask.retrieveSignerFromPort ('[-interactive]')
- Using Jython list:
AdminTask.retrieveSignerFromPort (['-interactive'])
retrieveSignerInfoFromPort
The retrieveSignerInfoFromPort command retrieves signer information from a port on a remote
host.
Target object
None
Required
parameters and return values
- -host
-
The host name of the system from where the signer certificate will be
retrieved. (String, required)
- -port
-
The port of the remote system from where the signer certificate will be
retrieved. (Integer, required)
- -sslConfigName
-
The name of the SSL configuration object. (String, optional)
- -sslConfigScopeName
-
The management scope where the SSL configuration object is located. (String,
optional)
Examples
Interactive
mode example usage:
- Using Jacl:
$AdminTask retrieveSignerInfoFromPort {-interactive}
- Using Jython string:
AdminTask.retrieveSignerInfoFromPort ('[-interactive]')
- Using Jython list:
AdminTask.retrieveSignerInfoFromPort (['-interactive'])
Related tasks
Using the AdminTask object for scripted administration
Related Reference
Commands for the AdminTask object
Reference topic