Skip to content

Commit

Permalink
Update from SAP DITA CMS (squashed):
Browse files Browse the repository at this point in the history
commit f62bdd433ccd96f0eefd1138701a4581a6ab9cc9
Author: REDACTED
Date:   Fri Sep 13 14:36:43 2024 +0000

    Update from SAP DITA CMS 2024-09-13 14:36:43
    Project: dita-all/jjq1673438782153
    Project map: c2f780f61c744155b0bd42b6f38fb70c.ditamap
    Output: loiob2927cc326be495da9f4fea0b6bda2b3
    Language: en-US
    Builddable map: c590d25af285407ba12a69179a940c19.ditamap

commit eb0e6c66d9e7a5cfbfa71324d43dc65b21123c91
Author: REDACTED
Date:   Fri Sep 13 10:36:37 2024 +0000

    Update from SAP DITA CMS 2024-09-13 10:36:37
    Project: dita-all/jjq1673438782153
    Project map: c2f780f61c744155b0bd42b6f38fb70c.ditamap
    Output: loiob2927cc326be495da9f4fea0b6bda2b3
    Language: en-US
    Builddable map: c590d25af285407ba12a69179a940c19.ditamap

commit cbc81b1cf76e50b04898fbd2bdb39fc3057a99d9
Author: REDACTED
Date:   Thu Sep 12 16:36:56 2024 +0000

    Update from SAP DITA CMS 2024-09-12 16:36:56
    Project: dita-all/jjq1673438782153
    Project map: c2f780f61c744155b0bd42b6f38fb70c.ditamap
    Output: loiob2927cc326be495da9f4fea0b6bda2b3
    Language: en-US
    Builddable map: c590d25af285407ba12a69179a940c19.ditamap

##################################################
[Remaining squash message was removed before commit...]
  • Loading branch information
ditaccms-bot committed Sep 13, 2024
1 parent 9573581 commit dc6850a
Show file tree
Hide file tree
Showing 4 changed files with 14 additions and 299 deletions.
32 changes: 2 additions & 30 deletions docs/1-connectivity-documentation/initial-configuration-db9170a.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,6 @@ After installing and starting the Cloud Connector, log on to the administration
- You have downloaded and installed the Cloud Connector, see [Installation](installation-57ae3d6.md).
- You have assigned one of these roles/role collections to the subaccount user that you use for initial Cloud Connector setup, depending on the SAP BTP environment in which your subaccount is running:

> ### Note:
> For the **Cloud Foundry** environment, you must know on which cloud management tools feature set \(A or B\) your account is running. For more information on feature sets, see [Cloud Management Tools — Feature Set Overview](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/caf4e4e23aef4666ad8f125af393dfb2.html "Cloud management tools represent the group of technologies designed for managing SAP BTP.") :arrow_upper_right:.

<table>
<tr>
Expand All @@ -54,26 +51,7 @@ After installing and starting the Cloud Connector, log on to the administration
<tr>
<td valign="top">

**Cloud Foundry** \[feature set **A**\]

</td>
<td valign="top">

The user must be a *member of the global account* that the subaccount belongs to.

Alternatively, you can assign the user as *Security Administrator*.

</td>
<td valign="top">

[Add Members to Your Global Account](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/4a0491330a164f5a873fa630c7f45f06.html "Add users as global account members using the SAP BTP cockpit.") :arrow_upper_right:

</td>
</tr>
<tr>
<td valign="top">

**Cloud Foundry** \[feature set **B**\]
**Cloud Foundry**

</td>
<td valign="top">
Expand All @@ -89,7 +67,7 @@ After installing and starting the Cloud Connector, log on to the administration
</td>
<td valign="top">

[Default Role Collections \[Feature Set B\]](what-is-sap-btp-connectivity-daca64d.md#loiodaca64dacc6148fcb5c70ed86082ef91__table_default_role_collections_setB)
[Default Role Collections](what-is-sap-btp-connectivity-daca64d.md#loiodaca64dacc6148fcb5c70ed86082ef91__table_default_role_collections_setB)

[Role Collections and Roles in Global Accounts, Directories, and Subaccounts](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/0039cf082d3d43eba9200fe15647922a.html "SAP BTP provides a set of role collections to set up administrator access to your global account and subaccounts.") :arrow_upper_right:

Expand Down Expand Up @@ -207,9 +185,6 @@ Press *Add Subaccount* to define a subaccount. This will open a dialog or wizard

*File-based* configuration lets you use an authentication data file downloaded from your subaccount on SAP BTP to simplify and accelerate subaccount configuration in the Cloud Connector.

> ### Restriction:
> Authentication data download from SAP BTP is available for subaccuonts in multi-cloud foundation, feature set B only.
![](images/SCC_InitialConfig_-_ManualFileBasedConfig_7edd7f1.png)

3. \(Skip if you have selected *file-based* configuration\) For *manual* configuration, the following dialog is shown:
Expand Down Expand Up @@ -290,9 +265,6 @@ Press *Add Subaccount* to define a subaccount. This will open a dialog or wizard

4. \(Skip if you have selected *manual* configuration\) For the *file-based* approach using authentication data, the following dialog is shown:

> ### Restriction:
> Authentication data download from SAP BTP is available for subaccuonts in multi-cloud foundation, feature set B only.
![](images/SCC_InitialConfig_-_FileBasedConfig_ab635bc.png)

You can download the authentication data file from your subaccount in the SAP BTP cockpit. To do so,
Expand Down
28 changes: 2 additions & 26 deletions docs/1-connectivity-documentation/managing-subaccounts-f16df12.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,9 +30,6 @@ You can connect to several subaccounts within a single Cloud Connector installat

You have assigned one of these roles/role collections to the subaccount user that you use for initial Cloud Connector setup, depending on the SAP BTP environment in which your subaccount is running:

> ### Note:
> For the **Cloud Foundry** environment, you must know on which cloud management tools feature set \(A or B\) your account is running. For more information on feature sets, see [Cloud Management Tools — Feature Set Overview](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/caf4e4e23aef4666ad8f125af393dfb2.html "Cloud management tools represent the group of technologies designed for managing SAP BTP.") :arrow_upper_right:.

<table>
<tr>
Expand All @@ -55,28 +52,7 @@ More Information
<tr>
<td valign="top">

**Cloud Foundry** \[feature set **A**\]

</td>
<td valign="top">

The user must be a *member of the global account* that the subaccount belongs to.

Alternatively, you can assign the user as *Security Administrator*.

</td>
<td valign="top">

[Add Members to Your Global Account](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/4a0491330a164f5a873fa630c7f45f06.html "Add users as global account members using the SAP BTP cockpit.") :arrow_upper_right:

<?sap-ot O2O class="- topic/xref " href="6752c4b8435c456ebf67a97ddbbcb267.xml" text="" desc="" xtrc="xref:5" xtrf="file:/home/builder/src/dita-all/jjq1673438782153/loiob2927cc326be495da9f4fea0b6bda2b3_en-US/src/content/localization/en-us/f16df12fab9f4fe1b8a4122f0fd54b6e.xml" output-class="" outputTopicFile="file:/home/builder/tp.net.sf.dita-ot/2.3/plugins/com.elovirta.dita.markdown_1.3.0/xsl/dita2markdownImpl.xsl" ?>

</td>
</tr>
<tr>
<td valign="top">

**Cloud Foundry** \[feature set **B**\]
**Cloud Foundry**

</td>
<td valign="top">
Expand All @@ -92,7 +68,7 @@ Alternatively, you can assign a *custom role collection* to the user that includ
</td>
<td valign="top">

[Default Role Collections \[Feature Set B\]](what-is-sap-btp-connectivity-daca64d.md#loiodaca64dacc6148fcb5c70ed86082ef91__table_default_role_collections_setB)
[Default Role Collections](what-is-sap-btp-connectivity-daca64d.md#loiodaca64dacc6148fcb5c70ed86082ef91__table_default_role_collections_setB)

[Role Collections and Roles in Global Accounts, Directories, and Subaccounts](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/0039cf082d3d43eba9200fe15647922a.html "SAP BTP provides a set of role collections to set up administrator access to your global account and subaccounts.") :arrow_upper_right:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,7 @@ Enable custom identity provider \(IDP\) authentication to configure a Cloud Foun

[Context](use-a-custom-idp-for-subaccount-configuration-2022612.md#loio202261235a204db5ba0b35bbaa6d40ff__context)

[Get the URL \[Feature Set A\]](use-a-custom-idp-for-subaccount-configuration-2022612.md#loio202261235a204db5ba0b35bbaa6d40ff__fsa)

[Get the URL \[Feature Set B\]](use-a-custom-idp-for-subaccount-configuration-2022612.md#loio202261235a204db5ba0b35bbaa6d40ff__fsb)
[Get the URL](use-a-custom-idp-for-subaccount-configuration-2022612.md#loio202261235a204db5ba0b35bbaa6d40ff__fsb)

[Get the One-Time Passcode](use-a-custom-idp-for-subaccount-configuration-2022612.md#loio202261235a204db5ba0b35bbaa6d40ff__pass)

Expand Down Expand Up @@ -97,72 +95,23 @@ To enable custom IDP authentication, for each of these operations you must enter
![](images/SCC_InitialConfig_-_DefineCustomIDP_RefreshCertificate_8f2a4f9.png)


To retrieve the one-time generated passcode, you must use the correct login URL for single sign-on \(SSO\) to access your custom IDP. The procedure to get this URL depends on the SAP BTP feature set you are using.

> ### Note:
> To choose the right procedure, you must know on which cloud management tools feature set \(A or B\) your SAP BTP account is running. For more information on feature sets, see [Cloud Management Tools — Feature Set Overview](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/caf4e4e23aef4666ad8f125af393dfb2.html "Cloud management tools represent the group of technologies designed for managing SAP BTP.") :arrow_upper_right:.
To retrieve the one-time generated passcode, you must use the correct login URL for single sign-on \(SSO\) to access your custom IDP.

> ### Tip:
> As of Cloud Connector version 2.17, you can import subaccount authentication data to simplify the process when using custom IdPs. Instead of using the SSO passcode approach, we strongly recommend that you import an authentication data file when connecting subaccounts in multi-cloud foundation, feature set B.
> As of Cloud Connector version 2.17, you can import subaccount authentication data to simplify the process when using custom IdPs. Instead of using the SSO passcode approach, we strongly recommend that you import an authentication data file.
>
> For more information, see [Set up Connection Parameters and HTTPS Proxy](https://help.sap.com/docs/connectivity/sap-btp-connectivity-cf/cloud-connector-initial-configuration?version=Cloud#set-up-connection-parameters-and-https-proxy) \(steps 2 + 4: file-based subaccount configuration\).
**Next Step**

[Get the URL \[Feature Set A\]](use-a-custom-idp-for-subaccount-configuration-2022612.md#loio202261235a204db5ba0b35bbaa6d40ff__fsa)

[Get the URL \[Feature Set B\]](use-a-custom-idp-for-subaccount-configuration-2022612.md#loio202261235a204db5ba0b35bbaa6d40ff__fsb)

> ### Caution:
> Mind the respective user rights described in the prerequisites for [Initial Configuration](initial-configuration-db9170a.md#loiodb9170a7d97610148537d5a84bf79ba2__prereq) and [Managing Subaccounts](managing-subaccounts-f16df12.md). For feature set A, it is mandatory to be a subaccount *Security Administrator*, not only a global account member.
Back to [Content](use-a-custom-idp-for-subaccount-configuration-2022612.md#loio202261235a204db5ba0b35bbaa6d40ff__content)



<a name="loio202261235a204db5ba0b35bbaa6d40ff__fsa"/>

## Get the URL \[Feature Set A\]

Choose one of the following options:

**Option 1: Assemble the URL**

The URL pattern is *https://login.cf.<btp-region-host\>/passcode*.

1. Get the SAP BTP region host, for example, *eu10.hana.ondemand.com*.
2. Assemble the final URL to be used, in this case: *https://login.cf.eu10.hana.ondemand.com/passcode*.

**Option 2: Get the URL Using the Cloud Foundry CLI**

Use the Cloud Foundry [CLI](https://docs.cloudfoundry.org/cf-cli/) to perform the following steps:

1. Execute the command `cf api` to navigate to the SAP BTP region.
2. Execute `cf login --sso` to get the URL.

> ### Sample Code:
> ```
> $ cf api api.cf.eu10.hana.ondemand.com
> Setting api endpoint to api.cf.eu10.hana.ondemand.com...
> OK
> api endpoint: https://api.cf.eu10.hana.ondemand.com
> api version: 2.156.0
> $ cf login --sso
> API endpoint: https://api.cf.eu10.hana.ondemand.com
> Temporary Authentication Code ( Get one at https://login.cf.eu10.hana.ondemand.com/passcode ):
> ```
**Next Step**

[Get the One-Time Passcode](use-a-custom-idp-for-subaccount-configuration-2022612.md#loio202261235a204db5ba0b35bbaa6d40ff__pass)
> Mind the required user rights described in the prerequisites for [Initial Configuration](initial-configuration-db9170a.md#loiodb9170a7d97610148537d5a84bf79ba2__prereq) and [Managing Subaccounts](managing-subaccounts-f16df12.md).
Back to [Content](use-a-custom-idp-for-subaccount-configuration-2022612.md#loio202261235a204db5ba0b35bbaa6d40ff__content)



<a name="loio202261235a204db5ba0b35bbaa6d40ff__fsb"/>

## Get the URL \[Feature Set B\]
## Get the URL

Choose one of the following options:

Expand Down
Loading

0 comments on commit dc6850a

Please sign in to comment.