
Conversion from CA Top Secret (TSS) to RACF
This offering includes 5 deliverables: review of the present TSS security system, preparation of a migration plan, actual conversion, RACF administration and reporting.post-conversion testing and tuning. If the client has more than one LPAR to convert (for example, TEST and PROD) then all 5 deliverables are needed separately for each LPAR.
Deliverable One: Review of present TSS Security System
During the years, depending on their security policy and business needs, each institution has added various IBM and 3rd party subsystems and products resulting in quite distinct TSS implementations. Therefore, the Review (mostly examination of the TSSCFILE and interviews with main stakeholders) serves as a base for a unique conversion proposal.
1.1 Assess the current
CA-Top Secret database
Some features in CA-Top Secret do not convert easily or on a one-to-one correspondence
to RACF. In most cases, each vendor’s product documentation will have
published RACF installation instructions and these should be reviewed. We
Identify all vendor product features you are using for which RACF does not
have an equivalent function for, then we determine alternative ways of providing
the same protection using RACF functions. Also, we will check your OS/390
base product code for any security-related usermods, accounting exits, JES2
exits, and so forth.
1.2 Decide on how to
convert the security database
Our choice is a combination of:
• Leasing a conversion tool.
• Wrap RACF commands around specific output from TSS, master catalog,
whenever tool is not enough.
• Propose new group structure.
• Manual adjustments.
1.3 Analyze the current
system environment
We will complete a comprehensive, detailed review of any products, programs,
or interfaces that perform security functions. We may have to modify program
code or write program code or exits. To analyze your current system environment,
we start by listing all hardware and software products you have installed.
For each 3rd party product that has a security interface, we define entries
in the Class Definition Table (ICHRRCDE) and Router Table (ICHRFR01).
1.4 Preparing the RACF
test system
A test system, similar in size and nature to one that might be used for an
OS/390 software upgrade, has to be available for the migration project. We
need the RACF test system on a “dedicated” basis for about two
to three months to complete this project in a timely and efficient manner.
By a “dedicated” test system, we mean one that is available during
the normal working day so that the project team can work on the environment
during their normal day-to-day work schedule.
1.5 Assemble a conversion
team
After the Review is complete, a conversion team including our consultants
and client's personnel (representatives from systems programming, security
and application programming) is assembled with an appointed project manager.
We work hard to convince the client that some changes are inevitable by explaining
their benefits.
1.6 Knowledge transfer
You need to determine who must receive RACF education before the project starts,
when the education should be completed, and which classes should be attended.
This education could include formal IBM-taught classes, self-study courses,
or classes you may develop in-house for help desk or end-user training. During
all stages of the project we help your staff to gain RACF skills and to understand
the nitty-gritty details of how and why things are set up.
Deliverable Two: Prepare Conversion project plan
This task simply means documenting all the tasks that have been identified, who is to do them, and when they are to be done.
2.1 Install RACF
We install RACF, typically on a brand new test system apart from the production
system that contains CA-Top Secret.
2.2 Prepare Conversion
Programs
In this phase, we examine the conversion programs to be used to convert the
CA-Top Secret to RACF. These programs should be customized based on your specific
requirements.
2.3 Review naming conventions
Naming conventions are important, because high-level qualifiers of data sets
play a more important role in RACF than they do in CA-Top Secret. For example,
CA-Top Secret allows the use of generic characters for masking of high-level
qualifiers, while RACF does not.
2.4 Review security procedures
Identify all procedures that will change due to the migration to RACF. Typical
procedures of this type include how help-desk personnel are to change passwords,
or how operators and software automation products interact with RACF and OS/390
operations.
2.5 RACF group structure
planning
This is a very important part of the database conversion. Our methodology
allows us to build a RACF group structure which is manageable, well-designed,
and meets your specific needs. For example, we propose our proven implementation
of RACF default groups based on type of user: employee, contractor, machine
user etc. Also we can implement access groups based on job-role concept.
2.6 Convert the security database
In this phase, we run our conversion programs to convert the CA-Top Secret
database to RACF commands. Through repetitive executions of the tool against
the CA-Top Secret database, we are able to build a functionally equivalent
RACF database. Final testing should verify the integrity of the user ID and
resource profile definitions.
2.7 Testing
A typical RACF testing sequence, or “cycle”, might be:
• Create a RACF database to match the CA-Top Secret database.
• IPL the test system with RACF.
• Execute the test plans.
• Review the results.
• Make any corrections to the conversion programs.
• Retest the system.
Several testing cycles are usually needed before your RACF environment is ready for testing against the full production system.
2.8 Production Cutover
Before migrating RACF to production, you probably want to test RACF with the
full production system.
Successful migrations freeze all changes to CA-Top Secret shortly before the
cutover weekend.
Deliverable Three: Actual TSS to RACF conversion
This task comprises the actual database migration of CA-Top Secret to IBM’s RACF.
3.1 TSS database clean-up
The migration from CA-Top Secret to RACF involves more than a conversion of
database records. We must first note that this is an excellent time (just
before your migration) to review, rethink, and polish your security policy.
A clear vision of what you want to produce will help the migration work, and
provide better results.
A fairly clean input database at the beginning of the migration will help
produce a higher quality result.
A pre-conversion review process should consider (and correct) obvious errors
in the database. It should also consider design and philosophical changes
that will produce a better database after migration. Again, small changes
here may make the migration much easier and produce a better result. Examples
are the replacement of "+" symbol in HLQs for datasets and removal
of partial strings for similar datasets from TSS PROFILES.
3.2 Create RACF test
system
The RACF database is practically empty, we use userid IBMUSER to run a skeleton
set of RACF commands to activate selected options of SETROPTS, corresponding
to equivalent options from TSSPARM together with profiles in class STARTED
for a core of system address spaces and started tasks. Also several TSO userids
having SPECIAL will be created. Once RACF is up and running we propose names
for primary and backup RACF databases, prepare the ICHRDSNT module and SYS1.RACF.PARMLIB
dataset and use IRRUT200 to allocate your new RACF databases.
3.3 Review TSSCFILE
The TSSCFILE is the input to our conversion tool together with information
extracted from Master catalog with LISTCAT ALL. We will make sure that any
new HLQs specifically needed are accounted for by creating corresponding groups
and dataset profiles with the attribute of WARNING. We will eximine TSSCFILE
for completeness (for example it may not have info about logonprocs for TSO
users) and take notice to update our tools with the missing info. In case
our group methodology is accepted by the client we will feed the structure
to the conversion tool.
3.4 Automated database
conversion
The conversion consists of jobs comprising RACF commands run in the following
order:
ADDGROUP defines all RACF
groups
ADDUSER defines all userids
ALTUSER changes to userids (revoke, special attributes)
CONNECT fills groups with users
ADDSD define dataset profiles
RDEFINE defines all general resources. Grouping profiles are created later.
GROUP PERMIT place groups on access lists
USER PERMIT place userids on access lists
The results in the following areas will be carefully examined:
Dataset profiles: all
having one and the same HLQ for "undercutting" (higher RACF access).
Class STARTED: note all profiles running as trusted. Replace with specific
access.
Converted OTRAN and PPT to RACF CICS classes.
Review changes to CICS regions JCL for proper keywords (XTRAN XCMD etc) and
preset terminal security
Converted TSS FACILITY to RACF APPL class.
Converted TSS BLP to profile ICHBLP in class FACILITY.
Converted powerfull attributes SPECIAL OPERATIONS AUDITOR and their group
equivalents.
Converted TSS FACILITY TSO to TSO userids.
Review procedure for password import.
Converted DB2 to profiles in RACF classes MDSNxx and DSNADM. RACF does not
protect DB2 commands (they should be protected by internal DB2 security).
Deliverable Four: Administration, Reporting and Documentation
We will provide comprehensive review and changes to Administration procedures, changes to SMF collect procedure and a new documentation for client RACF administrators .
4.1 RACFAdministration
This task comprises: changes to security administration due to converting
to RACF, update of security request forms, proposal of 3rd party tool (Consul,
VRA etc). Changes and/or replacement for client decentralized security administration
will be provided (simplified RACF panels etc).
4.2 RACF Reporting
TSS has its own log, while RACF uses SMF. We will advise how to replace existing
TSS reporting with equivalent tools: ICETOOL reporting, DB2 queries on output
from flat datasets for RACF database and SMF record 80, Consul CARLA queries.
4.3 Documentation
We will deliver a comprehensive document consisting of description of all
implemeted RACF controls with recommendations how to create new groups, userids,
profiles for started tasks, CICS transactions etc. Suggestions for future
improvements are also included.
Deliverable Five: Post-conversion Testing and Tuning
This task must be performed as a joint effort of the conversion team and teams of testers from all client areas.
5.1 Acceptance testing
without end-users
For this task we will prepare and support the converted system for initial
verification and pre-acceptance tests by client security staff. If required,
this will include weekend support. This testing is not to include end-users
or production work. If required, during this task, the consultant(s) will
provide knowledge transfer and/or informal training on the new environment
to client security staff.
5.2 Acceptance testing with end-users
We will prepare and support the converted system for end-user testing and
verification. This end-user test is not to include production work. We will
provide onsite support including weekends for this task. No end-user training
is expected.
5.3 Production cutover
We will prepare and support the converted system for the final production
cutover. If required, this will include weekend work. Following the production
cutover, we will provide close support and monitoring of the new environment.
This will include onsite support during normal business hours and 24-hour
on-call support throughout the follow-up period. Client staff will be required
to attend the production activation.