Authorization Commands

Top  Previous  Next

The following commands are used to set, save, load, delete Amazon S3 authorizations, that is, Access Key ID and Secret Access Key pairs.

saveauth ACCESS_KEY_ID  SECRET_ACCESS_KEY [NAME]

Save Access Key ID and Secret Access Key in S3Express.
Access Key ID and Secret Access Key are stored encrypted in the Windows Registry and can then be recalled with the command loadauth.

 

Parameter

Description

ACCESS_KEY_ID

Required. This is the Amazon Access Key ID that S3Express should use to connect to Amazon S3.

SECRET_ACCESS_KEY

Required. This is the corresponding Amazon Secret Access Key that S3Express should use to connect to Amazon S3.

NAME

Optional. The name for this authorization. A name can be used to store multiple authorizations in S3Express. If a name is not use the ACCESS_KEY_ID and SECRET_ACCESS_KEY are saved without a name, as default authorization.

 

loadauth [NAME]

Load a previously saved Access Key ID and Secret Access Key in S3Express for use.

 

Parameter

Description

NAME

Optional. The name of the authorization to load. If a name is not specified the default ACCESS_KEY_ID and SECRET_ACCESS_KEY are loaded.

 

showauth [NAME]

Show previously saved Access Key ID and Secret Access Key in S3Express.

 

Parameter

Description

NAME

Optional. The name of the authorization to show. If a name is not specified the default ACCESS_KEY_ID and SECRET_ACCESS_KEY are shown.
 
Note: You can show all authorizations saved in S3Express using command:
showauth <all>

 

rmauth [NAME]

Remove previously saved Access Key ID and Secret Access Key from S3Express.

 

Parameter

Description

NAME

Optional. The name of the authorization to remove. If a name is not specified the default ACCESS_KEY_ID and SECRET_ACCESS_KEY are removed.
 
Note: You can remove all authorizations saved in S3Express using command:
rmauth <all>

 

Authorization Examples:
 
To save the Access Key ID and Secret Access Key pair FASWQDSDSSSZXAS1SA and AsFZEDy2BQfFSFzFfgKyyOF/xCaRcK4RMc as the default S3Express authorization use command:
saveauth FASWQDSDSSSZXAS1SA AsFZEDy2BQfFSFzFfgKyyOF/xCaRcK4RMc
 
This authorization can then be recalled each time by using command:
loadauth
 
Note that by default S3Express loads the latest used authorization at startup automatically, so once you saved the pair FASWQDSDSSSZXAS1SA and AsFZEDy2BQfFSFzFfgKyyOF/xCaRcK4RMc using saveauth FASWQDSDSSSZXAS1SA AsFZEDy2BQfFSFzFfgKyyOF/xCaRcK4RMc, S3Express will automatically reload it every time it starts, no need to use loadauth each time.
 
To remove this authorization from S3Express, use:
rmauth
 
To show this authorization in S3Express, use:
showauth
 
 
You can also save multiple authorizations in S3Express. For instance you could have:
saveauth FASWQDSDSSSZXAS1SA AsFZEDy2BQfFSFzFfgKyyOF/xCaRcK4RMc
but also:
saveauth 1FASWQDSDSSSZXAS1SA 1AsFZEDy2BQfFSFzFfgKyyOF/xCaRcK4RMc MYAUTH1
and
saveauth 2FASWQDSDSSSZXAS1SA 2AsFZEDy2BQfFSFzFfgKyyOF/xCaRcK4RMc MYAUTH2
 
You would then load the required authorization using the loadauth command ,e.g.:
loadauth
or
loadauth MYAUTH1
or
loadauth MYAUTH2
 
Note that by default S3Express loads the latest used authorization at startup automatically, so after loading MYAUTH2, that authorization would be reloaded automatically at next S3Express startup.
 
To remove the MYAUTH1 authorization from S3Express, use:
rmauth MYAUTH1
 
To show the MYAUTH1 authorization, use:
showauth MYAUTH1
 
To show all authorizations saved in S3Express, use:
showauth <all>
 
To remove all authorizations saved in S3Express, use:
rmauth <all>