Set up SAP S/4HANA
This guide explains how to create a dedicated communication user in SAP S/4HANA and grant the authorizations Atlan needs to extract metadata over RFC.
Before setting up user accounts, understand how Atlan connects to SAP S/4HANA.
Prerequisites
Before you begin, make sure you have:
- Administrative access to SAP S/4HANA, including the ability to create users (
SU01) and maintain roles (PFCG). - Self-Deployed Runtime deployed that meets the system requirements. For installation, see Install Self-Deployed Runtime.
- SAP system details, including:
- Host
- System number
- Client number
Create communication user
- In the SAP GUI command field, enter
SU01and press Enter to open User Maintenance. - In the User field, enter a name for the new service user and click Create.
- On the Address tab, provide the required contact information.
- Open the Logon Data tab and:
- Set User Type to C (Communications Data).
- Set an initial password (enter it twice).
- Click Save to create the user.
You assign the authorizations in the next section.
Grant required authorizations
Atlan extracts metadata over RFC using read-only function modules, so the communication user needs two authorization objects:
S_RFCto execute the RFC function modules.S_TABU_DISto read the data dictionary tables those modules query.
Grant the following values. All activities are display or execute only, so Atlan never writes to your SAP system.
S_RFC for RFC execution
| Field | Value | Purpose |
|---|---|---|
RFC_TYPE | FUGR | Authorize at the function-group level. |
RFC_NAME | SDTX, /SAPDS/RS_BASIS, SYST, RFC1 | Function groups that contain the required modules (see below). |
ACTVT | 16 (Execute) | Allow execution only. |
These function groups cover the function modules Atlan calls:
| Function module | Function group | Purpose |
|---|---|---|
RFC_READ_TABLE | SDTX | Reads metadata tables. |
/SAPDS/RFC_READ_TABLE2 | /SAPDS/RS_BASIS | Reads tables with long-string (STRG) columns that RFC_READ_TABLE can't return, such as CDS view source. |
STFC_CONNECTION | SYST | Verifies connectivity between Atlan and SAP S/4HANA. |
RFC_SYSTEM_INFO | RFC1 | Retrieves system metadata such as SYSID, operating system, and release version. |
/SAPDS/RFC_READ_TABLE2/SAPDS/RFC_READ_TABLE2 ships with the SAP Basis Plug-In (PI_BASIS) and is present on standard S/4HANA systems. Atlan uses it to read columns that the classic RFC_READ_TABLE returns as blank.
S_TABU_DIS for table reads
| Field | Value | Purpose |
|---|---|---|
ACTVT | 03 (Display) | Allow read-only table access. |
DICBERCLS | SS, &NC& | Table authorization groups for the dictionary tables Atlan reads. |
The data dictionary tables Atlan extracts belong to table authorization group SS. The &NC& group covers in-scope tables that aren't assigned to a group. To confirm the group for a specific table, your Basis team can check table TDDAT or use transaction SUCU.
If your security policy requires authorizing individual tables rather than a table authorization group, use S_TABU_NAM (ACTVT = 03, with TABLE set to each table name) instead of S_TABU_DIS. The exact list of tables the connector reads isn't published here. Contact your Atlan team and they provide it during implementation.
Assign authorizations to user
You can grant the authorization objects directly or, preferably, bundle them into a single role.
- Recommended: bundle into a PFCG role
- Grant the objects directly
- In the command field, enter
PFCGand press Enter to open Role Maintenance. - Enter a name for a new single role (for example,
Z_ATLAN_RFC_METADATA) and click Single Role. - On the Authorizations tab, open the authorization data and add the
S_RFCandS_TABU_DISobjects with the field values from the previous section. - Generate the authorization profile.
- On the User tab, assign the role to the communication user you created, then Save.
Add the S_RFC and S_TABU_DIS authorization objects, with the field values from the previous section, to a profile assigned to the communication user. Use this approach when an existing role or profile already manages the user's authorizations.
The user must change the password on first login.
Next steps
- Crawl SAP S/4HANA: Follow the instructions to extract metadata using the configured service user.