Skip to content

Commit

Permalink
Update from SAP DITA CMS (squashed):
Browse files Browse the repository at this point in the history
commit e09b2ef70ef7ff2337fcb92920cadf6197677139
Author: REDACTED
Date:   Tue Oct 29 09:03:48 2024 +0000

    Update from SAP DITA CMS 2024-10-29 09:03:48
    Project: dita-all/slu1713332208086
    Project map: 6d6c94be23b547a19d534f13dd6d51a7.ditamap
    Output: loiocc0ab4c7365e43bbbee9eae27deb32da
    Language: en-US
    Builddable map: 446771d4951c4a6988252269c21d94ba.ditamap

commit e80a9ae4a8dcb7da62087c04615fd2af709d1b6a
Author: REDACTED
Date:   Tue Oct 29 08:36:50 2024 +0000

    Update from SAP DITA CMS 2024-10-29 08:36:50
    Project: dita-all/slu1713332208086
    Project map: 6d6c94be23b547a19d534f13dd6d51a7.ditamap
    Output: loiocc0ab4c7365e43bbbee9eae27deb32da
    Language: en-US
    Builddable map: 446771d4951c4a6988252269c21d94ba.ditamap

commit a5c77adafc4d3c1647f30c0929f75f6d3b006730
Author: REDACTED
Date:   Tue Oct 29 08:22:14 2024 +0000

    Update from SAP DITA CMS 2024-10-29 08:22:14
    Project: dita-all/slu1713332208086
    Project map: 6d6c94be23b547a19d534f13dd6d51a7.ditamap
    Output: loiocc0ab4c7365e43bbbee9eae27deb32da
    Language: en-US
    Builddable map: 446771d4951c4a6988252269c21d94ba.ditamap

##################################################
[Remaining squash message was removed before commit...]
  • Loading branch information
ditaccms-bot committed Oct 29, 2024
1 parent 8605e6d commit 25bb478
Show file tree
Hide file tree
Showing 302 changed files with 6,607 additions and 3,738 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ To enable SAP Integration Suite functionality, you must purchase an SAP Business

## Purchase a Customer Account

A customer account is an entitlement that allows you to host the capabilities of SAP Business Technology Platform on your landscape, with round the clock [Support](../70-Support/support-6abc874.md). To purchase an account, contact an SAP sales representative or visit us on [SAP Business Technology Platform](https://www.sap.com/sea/products/business-technology-platform.html) .
A customer account is an entitlement that allows you to host the capabilities of SAP Business Technology Platform on your landscape, with round the clock <?sap-ot O2O class="- topic/xref " href="6abc8746df294fe4ac5877e39683dee6.xml" text="" desc="" xtrc="xref:1" xtrf="file:/home/builder/src/dita-all/slu1713332208086/loiocc0ab4c7365e43bbbee9eae27deb32da_en-US/src/content/localization/en-us/1eda4034514f4c3aa262b112656f867f.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" ?> . To purchase an account, contact an SAP sales representative or visit us on [SAP Business Technology Platform](https://www.sap.com/sea/products/business-technology-platform.html) .

General information about SAP Integration Suite is available [here](https://www.sap.com/sea/products/integration-suite.html). Before making the purchase, you can use the estimator [tool](https://www.sap.com/products/business-technology-platform/price-list/estimator-tool.html) to derive the Pricing information for your business use case.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,16 @@ Subscribe to the SAP Integration Suitein SAP BTP cockpit and assign the Integrat

- You’ve created a subaccount in your assigned global account using the SAP BTP cockpit and added the desired service plans for Integration Suite to the subaccount. For more information on service plans, see [SAP Discovery Center - Integration Suite](https://discovery-center.cloud.sap/serviceCatalog/integration-suite?region=all).

- If you want to use Integration Suite with the **Starter** service plan, additionally assign the entitlement *integration\_flows* to your subaccount. This entitlement along with the appropriate quota assignment is a prerequiste to create custom integration flows. For more information about the service plans, see SAP Note [2903776](https://me.sap.com/notes/2903776).

> ### Note:
> If you are unable to assign the *integration\_flows* entitlement, contact the administrator of your subaccount or global account.

> ### Tip:
> We recommend you clear your browser cookies and cache after subscribing to the application and assigning roles. If you still can't access the application with the correct roles, log out and log back in to resolve the issue.
You can watch a short video to learn about subscribing and configuring initial access here:



Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -87,12 +87,17 @@ Tab
</th>
<th valign="top">

Cloud Integration

</th>
<th valign="top">

API Management

</th>
<th valign="top">

Cloud Integration
Event Mesh

</th>
<th valign="top">
Expand All @@ -114,12 +119,17 @@ Discover <span class="SAP-icons-V5"></span>
</td>
<td valign="top">

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Discover* \> *Integrations*

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Discover* \> *APIs*

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Discover* \> *Integrations*
<span style="color:#BB0000;"><span class="SAP-icons-V5"></span></span>

</td>
<td valign="top">
Expand All @@ -141,12 +151,17 @@ Design :pencil2:
</td>
<td valign="top">

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Design* \> *Integrations and APIs*

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Design* \> *Graph*

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Design* \> *Integrations and APIs*
<span style="color:#BB0000;"><span class="SAP-icons-V5"></span></span>

</td>
<td valign="top">
Expand All @@ -168,6 +183,11 @@ Test <span class="SAP-icons-V5"></span>
</td>
<td valign="top">

<span style="color:#BB0000;"><span class="SAP-icons-V5"></span></span>

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Test* \> *APIs*

</td>
Expand Down Expand Up @@ -195,12 +215,17 @@ Configure <span class="SAP-icons-V5"></span>
</td>
<td valign="top">

<span style="color:#BB0000;"><span class="SAP-icons-V5"></span></span>

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Configure* \> *APIs*

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

<span style="color:#BB0000;"><span class="SAP-icons-V5"></span></span>
<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Configure* \> *Event Mesh*

</td>
<td valign="top">
Expand All @@ -222,6 +247,11 @@ Engage <span class="SAP-icons-V5"></span>
</td>
<td valign="top">

<span style="color:#BB0000;"><span class="SAP-icons-V5"></span></span>

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span>

</td>
Expand Down Expand Up @@ -249,12 +279,17 @@ Monitor <span class="SAP-icons-V5"></span>
</td>
<td valign="top">

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Monitor* \> *Integrations and APIs*

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Monitor* \> *Analyze APIs*

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Monitor* \> *Integrations and APIs*
<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Monitor* \> *Event Mesh*

</td>
<td valign="top">
Expand All @@ -276,12 +311,17 @@ Inspect Resource Consumption <span class="SAP-icons-V5"></span>
</td>
<td valign="top">

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span>

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

<span style="color:#BB0000;"><span class="SAP-icons-V5"></span></span>

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span>
<span style="color:#BB0000;"><span class="SAP-icons-V5"></span></span>

</td>
<td valign="top">
Expand All @@ -303,6 +343,11 @@ Monetize <span class="SAP-icons-V5"></span>
</td>
<td valign="top">

<span style="color:#BB0000;"><span class="SAP-icons-V5"></span></span>

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

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span> *Monitor* \> *APIs*

</td>
Expand Down Expand Up @@ -349,6 +394,11 @@ NA

NA

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

NA

</td>
</tr>
<tr>
Expand All @@ -361,7 +411,7 @@ Settings :gear:

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span>

*Settings* \> *APIs*
*Settings* \> *Integrations*

*Settings* \> *Runtime*

Expand All @@ -370,13 +420,18 @@ Settings :gear:

<span style="color:#2B7D2B;"><span class="SAP-icons-V5"></span></span>

*Settings* \> *Integrations*
*Settings* \> *APIs*

*Settings* \> *Runtime*

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

<span style="color:#BB0000;"><span class="SAP-icons-V5"></span></span>

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

NA

</td>
Expand Down Expand Up @@ -471,7 +526,7 @@ Built-in support. You can activate built-in support by choosing<span class="SAP-
Explore our environment, and navigate to the following portals:

- SAP Business Accelerator Hub
- API Business Hub Enterprise \(if you've chosen the API Management capability\)
- Developer Hub \(If you've activated the API Management capability and chosen Developer Hub as a sub-capability.\)
- BTP Cockpit


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,9 +27,3 @@ We use **inbound** to refer to the communication direction when a sender system

[Basic Authentication](basic-authentication-2c4c2d9.md "Basic authentication allows a client to authenticate itself against the server based on user credentials.")

[Client Certificate Authentication and Certificate-to-User Mapping (Inbound), Neo Environment](https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/4b5afdd6bcbd4bc8a3d50d9ad2ef6482.html "This option includes an authentication step based on a digital client certificate and the mapping of the certificate to a user.") :arrow_upper_right:

[Client Certificate Authentication (Inbound), Neo Environment](https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/c1eeeab4877147ffa6a5997c76eaaaca.html "This option includes an authentication step based on a digital client certificate.") :arrow_upper_right:

[Setting Up Inbound HTTP Connections (with OAuth), Neo Environment](https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/e5cb7ea5a4534c23bd88c16a51889a55.html "") :arrow_upper_right:

Original file line number Diff line number Diff line change
Expand Up @@ -46,20 +46,11 @@ To enable communication with such a variety of systems, Cloud Integration suppor
- Connections to an external message broker using the Advanced Message Queuing Protocol \(AMQP\)


For an overview of the communication protocols and the available adapters \(that are based on a certain protocol\), see [Connectivity (Adapters)](https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/55325f2a722c4f67bb7752b369b09ff8.html "You have the option to specify which technical protocols should be used to connect a sender or a receiver to the tenant.") :arrow_upper_right:.

> ### Note:
> The procedure to set up HTTP connections depends on whether you use Cloud Integration in the Cloud Foundry or in the Neo environment.
**Related Information**


[Configuring Inbound HTTP Connections](configuring-inbound-http-connections-f568400.md "")

[Configuring Inbound HTTP Connections, Neo Environment](https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/bd1dbc4ba360426ab2244a9ae441ded6.html "") :arrow_upper_right:

[Setting Up Inbound SFTP Connections](setting-up-inbound-sftp-connections-d8fb958.md "Using the SFTP sender adapter, you connect an SAP Integration Suite tenant with an SFTP server so that the tenant can read data from the SFTP server (in a process referred to as polling).")

[Setting Up Inbound Mail Connections](setting-up-inbound-mail-connections-6ad4956.md "Using the mail sender adapter, you connect the tenant with an e-mail server so that the tenant can read data from the e-mail server (in a process referred to as polling).")

[Tutorial: Set Up Inbound OAuth Client Credentials Grant Authentication for API Clients with SAP-Generated Certificate](https://developers.sap.com/tutorials/btp-integration-suite-oauth-client-certificate.html)
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
16 changes: 16 additions & 0 deletions docs/ISuite/40-RemoteSystems/introduction-10dc4a3.md
Original file line number Diff line number Diff line change
Expand Up @@ -1139,6 +1139,22 @@ See: [JDBC for SAP HANA Platform \(On-Premise\)](../50-Development/jdbc-for-sap-
<tr>
<td valign="top">

*Jira*

Receiver adapter

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

Enables SAP Integration Suite to connect to Jira.

See: [Jira Receiver Adapter](../50-Development/jira-receiver-adapter-d15b560.md)

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

*JMS*

Sender adapter
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,12 +27,17 @@ Simply spoken, this authentication is established using the following sequent st

- Using a client certificate from the service key

If you use a client certificate, you can either use an own \("external"\) client certificate or a client certificate generated by SAP \(see [Service Key Types](service-key-types-0fc1446.md)\).
If you use a client certificate, you can either use an own \(*external*\) client certificate or a client certificate generated by SAP \(see [Service Key Types](service-key-types-0fc1446.md)\).

> ### Tip:
> For a step-by-step description of how to set up this use case, check out the following tutorial:
>
> [Set Up Inbound OAuth Client Credentials Grant Authentication for Senders Calling Integration Flows with SAP-Generated Certificate](https://developers-qa-blue.wcms-nonprod.c.eu-de-2.cloud.sap/tutorials/btp-integration-suite-oauth-integration-flow.html)
> [Set Up Inbound OAuth Client Credentials Grant Authentication for Senders Calling Integration Flows with SAP-Generated Certificate](https://developers.sap.com/tutorials/btp-integration-suite-oauth-integration-flow.html)
> ### Caution:
> If you use an *external* client certificate \(*Key Type* parameter set to *External Certificate* when creating the corresponding service key, see [Creating Service Instance and Service Key for Inbound Authentication](creating-service-instance-and-service-key-for-inbound-authentication-19af5e2.md)\), the certificate must be signed by a CA from the list specified in the following topic:
>
> See: [Trusted Authorities for X.509 Certificates](https://help.sap.com/docs/btp/sap-business-technology-platform/trusted-certificate-authorities-for-x-509-secrets?version=Cloud)

2. Token server issues access token.
Expand Down
2 changes: 0 additions & 2 deletions docs/ISuite/40-RemoteSystems/specific-use-cases-8fdb213.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,3 @@

[Using Custom IDP with SAP Cloud Integration](https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/c59610d483974fcda631af4a2aae586b.html "") :arrow_upper_right:

[Setting Up OAuth Configurations in Customer Account, Neo Environment](https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/b5e75eaf95534baaa7c9bc2ac020391c.html "With a REST API you can manage roles and their assignments to users.") :arrow_upper_right:

Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
<!-- loio0a383737f6cd4abfb3f1c58680747152 -->

# Update Service Instance that Contains Deprecated client\_x509 Grant Type

This information is relevant for you when you operate scenarios using Cloud Integration inbound authentication with client certificates and service instances with client\_x509 grant type. This affects all users who have set up such a scenario before March 2022.

For SAP Cloud Integration, the client\_x509 grant type has already been removed from the SAP BTP cockpit user interface in March 2022.

By the end of 2024, grant-type *client\_x509* is deprecated. Grant type *client\_x509* was required to call Cloud Integration endpoints with an *External Certificate* \(see [Creating Service Instance and Service Key for Inbound Authentication](creating-service-instance-and-service-key-for-inbound-authentication-19af5e2.md)\). It is substituted by the *client\_credentials* grant type. While service instances with *client\_x509* grant type continue to work, its recommended to replace existing *client\_x509* service instances. To do this, replace the *client\_x509* grant type by *client\_credential* grant type.



<a name="loio0a383737f6cd4abfb3f1c58680747152__section_osh_w33_rcc"/>

## Updating Affected Service Instances

To find out if a service instance is affected, perform the following steps:

1. SAP BTP cockpit and select *Services* \> *Instances and Subscriptions* \> *.*

2. Select a service instance.

> ### Note:
> Only service instances with service *Process Integration Runtime* are relevant.
3. Select *View Parameters*.

![](images/grant-type-01_20fac43.png)

4. In the popup, choose the *JSON* tab.

5. If under *Grant-types* there is the entry *client\_x509*, this service instance is affected.

![](images/grant-type-02_0e87127.png)

6. Copy the JSON representation to a text editor and replace entry `client_x509` by `client_credentials`.

7. Save the text for later reference.

8. Create a new service instance and provide the JSON configuration from the text editor.

9. For each service key in the old service instance, create a new service key in the new service instance.

- Open each old service key and copy the value of *certificate* and *certificate-pinning*. You can open a service key by clicking the service key name. This will show the service key details.

Example:

```
{
"oauth": {
...,
...,
"certificate": "...",
"certificate-pinning": "...",
...,
...,
...
}
}
```
- During the creation of the service keys in the new instance, reuse the existing values from the old service instance. The key type must always have the key type *External Certificate*.
Example:
![](images/grant-type-04_b17141e.png)
- As long as the old service key is not deleted, the creation of the new service key fails with the following error message:
`Certificate already exists for Follower within Leader with appid […].`
Resolve this error by deleting the old service key before creating the new service key.
> ### Note:
> Deleting a service key means that the client that is using this specific certificate for inbound authentication is no longer able to call integration flow or API endpoints. It is crucial to make sure that a service key with the certificate is recreated in the new service instance.
See also: [Cloud Integration on CF - How to Setup Secure HTTP Inbound Connection with Client Certificates](https://community.sap.com/t5/technology-blogs-by-sap/cloud-integration-on-cf-how-to-setup-secure-http-inbound-connection-with/ba-p/13393777) \(SAP Community blog\)
Loading

0 comments on commit 25bb478

Please sign in to comment.