How do I setup CSFKEYS profile records and ACF2 Resource rules for ICSF?

Document ID : KB000014183
Last Modified Date : 14/02/2018
Show Technical Document Details
Question:

How do I setup CSFKEYS profile records and ACF2 Resource rules for ICSF? 

Answer:

CSFKEYS and XCSFKEY profiles are used to specify the attributes for ICSF keys. ICSF will also check the authorization of the user to access the keys saved in the ICSF data sets. These checks will also be in the CSFKEYS and XCSFKEY classes. 

The ACF2 ICSF CSFKEYS and XCSFKEY Profile Records provide a way to specify the ICSF attributes for the keys that are controlled by the CSFKEYS and XCSFKEY profiles. ICSF will perform EXTRACTS against CSFKEYS and XCSFKEY classes.

ACF2 CSFKEYS and XCSFKEY Profile Record syntax:

recid
ASYMUSE(HANDSHAK|SECXPORT) 
RESOURCE(resource) 
SYMXCERT(qualifier/certlabel) 
SYMXKEYS(keylabel) 
SYMXPORT(BYLIST|BYANY|BYONE)

The following example highlights how to set up a CSFKEYS record for a DES key labeled DES.SAFE.KEY in the ICSF CKDS dataset that should never be exported.

 ACF
 set profile(csfkeys) division(icsf)
 Insert safe.key RESOURCE(DES.SAFE.KEY) SYMXPORT(BYNONE)

ICSF will perform EXTRACTS against CSFKEYS and XCSFKEY classes. You must add the PCSF and PXCF classes to the current INFODIR:

 ACF       
 set control(gso) 
 change infodir types(r-pcsf r-pxcf) ADD
 F ACF2,REFRESH(INFODIR)

ICSF will also check the authorization(RACROUTE FASTAUTH) of the user to access the keys saved in the ICSF data sets. These checks will also be in the CSFKEYS and XCSFKEY classes. Both classes are defined to CA ACF2 using the 3 character class code of SAF and XCS respectively. Because the CSFKEYS class is defined with the SAF code, you may wish to override the definition with a CLASMAP record.

 ACF       
 set control(gso) 
 INSERT CLASMAP.CSFKEYS RESOURCE(csfkeys) RSRCTYPE(CSF) ENTITYLN(73)
F ACF2,REFRESH(CLASMAP)

If you do override the CLASMAP record, you should add the new class to the current INFODIR record. The three-character class code for XCSFKEY should also be added to the INFODIR record.

 ACF       
 set control(gso) 
 change infodir types(r-rcsf r-rxcs) ADD
 F ACF2,REFRESH(INFODIR)

For changes to CSFKEYS or XCSKEY rule to take effect:

 F ACF2,REBUILD(XCS)       
 F ACF2,REBUILD(CSF) 

For changes to CSFKEYS Profile records to take effect:

 F ACF2,REBUILD(CSFKEYS),CLASS(p)       
 F ACF2,OMVS(CSFKEYS) 

For details see the CA ACF2 for z/OS Administration Guide sections CSFKEYS and XCSFKEY Profile Record and Integrated Cryptographic Service Facility