This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

STS

Overview

Provides a Command-line Interface (CLI) that supports programmatic use of IaaS/PaaS products provided by SCP.

This guide provides a brief description of IAM service and how to call CLI.

Version

VersionStatusSupported Until
1.0CURRENT-

1 - CLIs

1.1 - Acquire temporary role credential

1.1.1 - 1.0

scpcli sts sts assume role
--role_session_name <value>
--role_indicator <value>
[--duration_seconds <value>]

Description

Acquire temporary role credential

State ACTIVE (CURRENT)

VersionSupported Until
1.0-

Parameters

NameTypeDescriptionExample
role_session_name
required
stringIdentifier for the assumed role session-
role_indicator
required
stringIdentifier of the role to assume. [offering:account_id:role_name]-
duration_seconds
optional
integerDuration of seconds of the role session-

Responses

NameDescriptionExample
assumed_role_userSRN and assumed role ID
credentialsTemporary security credentials

1.2 - Acquire temporary role credential from SAML Assertion

1.2.1 - 1.0

scpcli sts sts assume role with saml
--saml_assertion <value>
--role_indicator <value>
--principal_indicator <value>
[--duration_seconds <value>]

Description

Acquire temporary role credential from SAML Assertion

State ACTIVE (CURRENT)

VersionSupported Until
1.0-

Parameters

NameTypeDescriptionExample
saml_assertion
required
stringBASE64 encoded SAML response-
role_indicator
required
stringIdentifier of the role to assume. [offering:account_id:role_name]-
principal_indicator
required
stringIdentifier of the SAML provider in IAM. [offering:account_id:provider_name]-
duration_seconds
optional
integerDuration of seconds of the role session-

Responses

NameDescriptionExample
assumed_role_userSRN and assumed role ID
audienceValue of Recipient attribute of SubjectConfirmationData element of SAML
credentialsTemporary security credentials
issuerValue of Issuer element of SAML
subjectValue of NameID element in the Subject element of SAML
subject_typeFormat of nameID

1.3 - Create new Signature based on Session Token

1.3.1 - 1.0

scpcli sts sts object store authorization
--x_amz_date <value>
--x_amz_content_sha256 <value>
--url <value>
--method <value>
[--region <value>]
[--service <value>]

Description

Create new Signature based on Session Token

State ACTIVE (CURRENT)

VersionSupported Until
1.0-

Parameters

NameTypeDescriptionExample
x_amz_date
required
stringDate and time at which the request is signed-
x_amz_content_sha256
required
stringSHA256 hash of the request body-
url
required
stringThe URL of the request-
method
required
stringHTTP method used in the request-
region
optional
stringRegion where the request is made-
service
optional
stringService to which the request is made-

Responses

NameDescriptionExample
AuthorizationAuthorization header for object store authentication