An Introduction to Adabas SAF Security

This document provides an introduction to Adabas SAF Security (ADASAF).


Benefits and Features

The System Authorization Facility (SAF) is used by z/OS and compatible sites to provide rigorous control of the resources available to a user or group of users. Security packages such as RACF, CA-ACF2, and CA-Top Secret allow the system administrator:

  • to maintain user identification credentials such as User ID and password.

  • to establish profiles determining the datasets, storage volumes, transactions, and reports available to a user.

The resulting security repository and the infrastructure to administer it represent a significant investment. At the same time, the volume of critical information held by a business is constantly growing, as is the number of users referencing the data. The challenge of controlling these ever-increasing accesses requires a solution that is flexible, easy to implement and, above all, one that safeguards the company's investment.

Adabas SAF Security (ADASAF) enhances the scope of SAF-based security packages by integrating Adabas resources into the central security repository. ADASAF enables:

  • a single control and audit system for all resources.

  • industry-standard protection of Adabas data.

  • maximized return on investment in the security repository.

Resource Protection

Adabas SAF Security can be used to protect the following resources:

Adabas Resources

Adabas SAF Security can be used to protect the following Adabas resources:

Resource Protection
Adabas Nucleus Only authorized users are allowed to:
  • start an Adabas nucleus

  • perform Adabas nucleus administration functions

Adabas Utilities Only authorized users are allowed to execute utilities, and then only the appropriate ones. Authorization can be restricted by utility name/function/file as well as Database ID. For example, a user or group of users might be permitted to run ADAREP but not ADASAV against a particular database.
Database Files Users or groups of users can be permitted (or denied) access to the basic resource of database files.
Database Commands Access (READ/FIND) and update (STORE/UPDATE/DELETE) privileges can be granted to specific users or groups of users. To optimize performance, ADASAF disregards commands such as RC that are not file-specific.
Production Environment Data Distinction can be made between a user operating in a production system and the same user operating in a test environment. This is known as cross-level checking and could be used, for example, to prevent damage by an application program inadvertently cataloged against the wrong Database ID.
Transaction Data ADASAF can optionally validate requests to store or retrieve ET data.
Adabas Operator Commands Restrictions can be placed on Adabas operator commands that can be issued from the MVS console.
File Passwords and Cipher Codes Passwords and codes can be held in the security repository or supplied by a user exit and dynamically applied by ADASAF. This eliminates the need for the application to manage security data and removes the requirement to transmit sensitive information from the client to the database.
Adabas Basic Services Adabas Basic Services can be protected with ADASAF by selecting the level of protection required (main functions only or main functions and subfunctions) and defining the appropriate resource profiles and granting the necessary users access to those profiles.
Stored Procedures Only authorized users are allowed to invoke stored procedures.

This protection is provided by running Adabas SAF Security in the Adabas nucleus and utilities.

COR-based Add-ons Online Administration Resources

Adabas SAF Security can be used to protect the online administration resources of the following COR-based Add-on products:

  • Adabas SAF Security (SYSAAF)

  • Adabas Fastpath (SYSAFP)

  • Adabas Transaction Manager (SYSATM)

  • Adabas Vista (SYSAVI)

  • Adabas System Coordinator (SYSCOR)

This protection is provided by running Adabas SAF Security in the Adabas System Coordinator daemon.

Entire Net-Work Resources

Adabas SAF Security can be used to protect the following Entire Net-Work resources:

Resource Protection
Entire Net-Work

Only authorized users are allowed to:

  • start an Entire Net-Work job

  • perform Entire Net-Work administration functions

This protection is provided by running Adabas SAF Security under Entire Net-Work.

Components

Adabas SAF Security runs in the address space of the job whose resources it is protecting.

The graphic below shows an example of the ADASAF main module running under an Adabas nucleus.

graphics/adasaf.png

Local and remote mainframe users must first log on to their system using their Logon ID, usually a user name or code. Through the operating system or TP monitor, the installed security package performs authentication checks using the user’s supplied Logon ID and password.

During subsequent Adabas command processing, the Adabas router extracts the user's Logon ID from the system ACEE and makes it available to the Adabas nucleus for authorization checks.

Remote non-mainframe users must first undergo an authentication process in which they provide their mainframe credentials, as described in Remote Access to Adabas Nucleus.

Adabas Program Protection

Most security packages such as RACF, CA-ACF2, and CA-Top Secret provide installations with the ability to control who can execute what programs and to treat those programs as assets.

Individual load modules (programs) residing in specific libraries can be characterized as trusted and, when executed, can access datasets with greater privileges than those that the logon ID of the submitter would normally have.

The following is an example of how program protection may be used to prevent unauthorized versions of ADARUN (or any Adabas program) from being used to access Adabas databases:

  • USER10 has READ access to the production load library PROD.ADA.LOAD and NONE access to the production container datasets PROD.ADA001.* for Adabas database number 1.

  • Program ADARUN in library PROD.ADA.LOAD is defined to be trusted (all other programs in PROD.ADA.LOAD may also need to be defined as trusted).

  • This trusted ADARUN is granted UPDATE access to production container datasets PROD.ADA001.*.

  • Any attempt by USER10 to start an Adabas nucleus or run an Adabas utility against the production container datasets PRD.ADA001.* using an ADARUN from any load library other than PROD.ADA.LOAD will result in job failure due to insufficient access authority. Adding the Adabas SAF Security load modules into PROD.ADA.LOAD will ensure that the Adabas SAF Security load modules are afforded the same level of program protection as the other Adabas load modules in that library.

Note
The program protection described above is independent of Adabas SAF Security. Refer to the security package documentation of your installation or reach out to your security group regarding the availability of this feature for your installation.