Software AG Command Central 10.2 | Command Central Developer Reference | Using the Command Line Interface | Security Credentials Commands | sagcc add security credentials sharedsecret
 
sagcc add security credentials sharedsecret
Add shared secret for a landscape or an environment.
Syntax
*Command Central syntax:
sagcc add security credentials sharedsecret [environmentAlias=alias]  
secret=text_string  [options]
*Not supported by Platform Manager.
Arguments and Options
Argument or Option
Description
[environmentAlias=alias]
Optional. Specify the alias for the environment for which you want to set a shared secret.
If you omit this parameter, the command sets a global shared secret for the whole landscape.
secret=text_string
Specify a shared secret password that Platform Manager uses to encrypt or decrypt configuration passwords.
[options]
Optional. The command allows all options supported by the Command Line Interface. For a description of the options, see Common Options.
Examples When Executing on Command Central
*To configure “mysecret” as the global shared secret for the landscape:
sagcc add security credentials sharedsecret secret=mysecret
*To configure “mysecret123” as the shared secret for the environment with alias “env1”:
sagcc add security credentials sharedsecret environmentAlias=env1 
secret=mysecret123
*To update the proxy server details for a run-time component with ID “OSGI-SPM” that runs in the installation with alias name “sag01” that belongs to an environment with alias “Test”:
1. Configure “secret123” as the shared secret for the “Test” environment”:
sagcc add security credentials sharedsecret  
environment=Test secret=secret123
2. Retrieve the instance data for the configuration instance with ID “COMMON-PROXY” for the “OSGI-SPM” run-time component that runs in the “sag01” installation:
sagcc get configuration data sag01 OSGI-SPM COMMON-PROXY  
--output  configWithEncryptedData.xml
The configWithEncryptedData.xml file contains the proxy details including the password, encrypted with the “secret123” shared secret configured for the “Test” environment.
3. Edit the proxy details in the configWithEncryptedData.xml file as required without changing the encrypted password.
4. Update the instance data for the configuration instance with ID “COMMON-PROXY”:
sagcc update configuration data sag01 OSGI-SPM COMMON-PROXY  
--intput  configWithEncryptedData.xml
Command Central updates the proxy details using the data in the configEncryptedData.xml file and the “secret123” shared secret configured for the environment.

Copyright © 2013-2018 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release