💾 Archived View for gemini.bortzmeyer.org › rfc-mirror › rfc4534.txt captured on 2023-06-16 at 18:43:40.
⬅️ Previous capture (2021-11-30)
-=-=-=-=-=-=-
Network Working Group A. Colegrove
Request for Comments: 4534 H. Harney
Category: Standards Track SPARTA, Inc.
June 2006
Group Security Policy Token v1
Status of This Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (C) The Internet Society (2006).
Abstract
The Group Security Policy Token is a structure used to specify the
security policy and configurable parameters for a cryptographic
group, such as a secure multicast group. Because the security of a
group is composed of the totality of multiple security services,
mechanisms, and attributes throughout the communications
infrastructure, an authenticatable representation of the features
that must be supported throughout the system is needed to ensure
consistent security. This document specifies the structure of such a
token.
Colegrove & Harney Standards Track [Page 1]
RFC 4534 Group Security Policy Token v1 June 2006
Table of Contents
1. Introduction ....................................................3
2. Token Creation and Receipt ......................................4
3. The Policy Token ................................................5
3.1. Token Identifiers ..........................................6
3.2. Registration Policy ........................................6
3.3. Rekey Policy ...............................................7
3.4. Group Data Policy ..........................................8
4. Security Considerations .........................................8
5. IANA Considerations .............................................8
6. References.......................................................9
6.1. Normative References .......................................9
6.2. Informative References ....................................10
7. Acknowledgements ...............................................10
Appendix A. Core Policy Token ASN.1 Module ........................11
Appendix B. GSAKMPv1 Base Policy ..................................13
B.1. GSAKMPv1 Registration Policy ..............................13
B.1.1. Authorization .......................................13
B.1.2. AccessControl .......................................14
B.1.3. JoinMechanisms ......................................15
B.1.3.1. alaCarte ...................................15
B.1.3.2. suite ......................................17
B.1.4. Transport ...........................................17
B.2. GSAKMPv1 Registration ASN.1 Module ........................17
B.3. GSAKMPv1 De-Registration Policy ...........................20
B.4. GSAKMPv1 De-Registration ASN.1 Module .....................21
B.5. GSAKMPv1 Rekey Policy .....................................22
B.5.1. Rekey Authorization ................................22
B.5.2. Rekey Mechanisms ...................................23
B.5.3. Rekey Event Definition .............................23
B.5.4. Rekey Methods ......................................24
B.5.4.1 Rekey Method NONE ..........................24
B.5.4.2 Rekey Method GSAKMP LKH ....................24
B.5.5 Rekey Interval ......................................25
B.5.6 Rekey Reliability ...................................25
B.5.6.1 Rekey Reliability Mechanism None ............25
B.5.6.2 Rekey Reliability Mechanism Resend ..........25
B.5.6.3 Rekey Reliability Mechanism Post ............26
B.5.7 Distributed Operation Policy ........................26
B.5.7.1 No Distributed Operation ....................26
B.5.7.2 Autonomous Distributed Mode .................26
B.6. GSAKMPv1 Rekey Policy ASN.1 Module ........................27
Appendix C. Data SA Policy ........................................30
C.1. Generic Data Policy .......................................30
C.2. Generic Data Policy ASN.1 Module ..........................30
Colegrove & Harney Standards Track [Page 2]
RFC 4534 Group Security Policy Token v1 June 2006
1. Introduction
The Multicast Group Security Architecture [RFC3740] defines the
security infrastructure to support secure group communications. The
policy token assumes this architecture in its definition. It defines
the enforceable security parameters for a Group Secure Association.
The policy token is a verifiable data construct signed by the Group
Owner, the entity with the authorization to create security policy.
The group controllers in a group will use the policy token to ensure
that the mechanisms used to secure the group are correct and to
enforce the access control rules for joining members. The group
members, who may contribute data to the group or access data from the
group, will use the policy token to ensure that the group is owned by
a trusted authority. Also, the members may want to verify that the
access control rules are adequate to protect the data that the member
is submitting to the group.
The policy token is specified in ASN.1 [X.208] and is to be DER
[X.660] encoded. This specification ability allows the token to
easily import group definitions that span different applications and
environments. ASN.1 allows the token to specify branches that can be
used by any multicast security protocol. Any group can use this
policy token structure to specify the use of multiple protocols in
securing the group.
Care was taken in this specification to provide a core level of token
specificity that would allow ease of extensibility and flexibility in
supporting mechanisms. This was done by using the following
abstracted construct:
Mechanism ::= SEQUENCE {
mechanismIdentifier OBJECT IDENTIFIER,
mechanismParameters OCTET STRING
}
This construct will allow the use of group mechanisms specified in
other documents with the policy token.
The policy token is structured to reflect the MSEC Architecture
layers for a Group Security Association. Each of the architectural
layers is identified and given a branch in the "Core" token. This
allows a high degree of flexibility for future protocol
specifications at each architectural layer without the need to change
the "Core" policy token, which can then act as a single point of
reference for defining secure groups using any mix of protocols for
any number of environments.
Colegrove & Harney Standards Track [Page 3]
RFC 4534 Group Security Policy Token v1 June 2006
2. Token Creation and Receipt
At the time of group creation or whenever the policy of the group is
updated, the Group Owner will create a new policy token.
To ensure authenticity of the specified policy, the Token MUST be
signed by the Group Owner. The signed token MUST be in accordance
with the Cryptographic Message Syntax (CMS) [RFC3852] SignedData
type.
The content of the SignedData is the token itself. It is represented
with the ContentType object identifier of
id-ct-msec-token OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.1.1}
The CMS sid value of the SignerInfo, which identifies the public key
needed to validate the signature, MUST be that of the Group Owner.
The signedAttrs field MUST be present. In addition to the minimally
required fields of signedAttrs, the signing-time attribute MUST be
present.
Upon receipt of a policy token, the recipient MUST check that
- the Group Owner, as identified by the sid in the SignerInfo, is
the expected entity.
- the signing-time value is more recent than the signing-time value
seen in a previously received policy token for that group, or the
policy token is the first token seen by the recipient for that
group.
- the processing of the signature successfully validates in
accordance with RFC 3852.
- the specified security and communication mechanisms (or at least
one mechanism of each choice) are supported and are in compliance
with the recipient's local policy.
Colegrove & Harney Standards Track [Page 4]
RFC 4534 Group Security Policy Token v1 June 2006
3. The Policy Token
The structure of the policy token is as follows:
Token ::= SEQUENCE {
tokenInfo TokenID,
registration SEQUENCE OF Registration,
rekey SEQUENCE OF GroupMngmtProtocol,
data SEQUENCE OF DataProtocol
}
tokenInfo provides information about the instance of the Policy Token
(PT).
registration provides a list of acceptable registration and
de-registration policy and mechanisms that may be used to manage
member-initiated joins and departures from a group. A NULL
sequence indicates that the group does not support registration
and de-registration of members. A member MUST be able to support
at least one set of Registration mechanisms in order to join the
group. When multiple mechanisms are present, a member MAY use
any of the listed methods. The list is ordered in terms of Group
Owner preference. A member MUST choose the highest listed
mechanism that local policy supports.
rekey provides the rekey protocols that will be used in managing the
group. The member MUST be able to accept one of the types of
rekey messages listed. The list is ordered in terms of Group
Owner preference. A member MUST choose the highest listed
mechanism that local policy supports.
data provides the applications used in the communications between
group members. When multiple applications are provided, the
order of the list implies the order of encapsulation of the data.
A member MUST be able to support all the listed applications and
if any choices of mechanisms are provided per application, the
member MUST support at least one of the mechanisms.
For the registration, rekey, and data fields, implementations
encountering unknown protocol identifiers MUST handle this gracefully
by providing indicators that an unknown protocol is among the
sequence of permissible protocols. If the unknown protocol is the
only allowable protocol in the sequence, then the implementation
cannot support that field, and the member cannot join the group. It
is a matter of local policy whether a join is permitted when an
unknown protocol exists among the allowable, known protocols.
Colegrove & Harney Standards Track [Page 5]
RFC 4534 Group Security Policy Token v1 June 2006
Protocols in addition to registration, rekey, and data SHOULD NOT be
added to subsequent versions of this Token unless the MSEC
architecture changes.
Each data field of the PT is specified further in the following
sections.
3.1. Token Identifiers
tokenInfo explicitly identifies a version of the policy token for a
particular group. It is defined as
TokenID ::= SEQUENCE {
tokenDefVersion INTEGER (1),
groupName OCTET STRING,
edition INTEGER OPTIONAL
}
tokenDefVersion is the version of the Group Policy Token
Specification. This specification (v1) is represented as one
(1). Changes to the structure of the Group Security Policy Token
will require an update to this field.
groupName is the identifier of the group and MUST be unique relative
to the Group Owner.
edition is an optional INTEGER indicating the sequence number of the
PT. If edition is present, group entities MUST accept a PT only
when the value is greater than the last value seen in a valid PT
for that group.
The type LifeDate is also defined to provide standard methods of
indicating timestamps and intervals in the Tokens.
LifeDate ::= CHOICE {
gt GeneralizedTime,
utc UTCTime,
interval INTEGER
}
3.2. Registration Policy
The registration security association (SA) is defined in the MSEC
Architecture. During registration, a prospective group member and
the group controller will interact to give the group member access to
the keys and information it needs to join the group and participate
in the group Data SA.
Colegrove & Harney Standards Track [Page 6]
RFC 4534 Group Security Policy Token v1 June 2006
The de-registration piece allows a current group member to notify the
Group Controller Key Server (GC/KS) that it will no longer be
participating in the Data SA.
Registration ::= SEQUENCE {
register GroupMngmtProtocol,
de-register GroupMngmtProtocol
}
The protocols for registration and de-registration are each specified
as
GroupMngmtProtocol ::= CHOICE {
none NULL,
supported Protocol
}
Protocol ::= SEQUENCE {
protocol OBJECT IDENTIFIER,
protocolInfo OCTET STRING
}
For example, register might be specified as the Group Secure
Association Key Management Protocol (GSAKMP) [RFC4535] registration
protocol. The OBJECT IDENTIFIER TBS would be followed by the
parameters used in GSAKMP registration as specified in Appendix B.1.
3.3. Rekey Policy
The Rekey SA is defined in the MSEC Architecture. During the Rekey
of a group, several changes can potentially be made:
- refresh/change group protection keys,
- update the policy token,
- change the group membership.
During Rekey, the membership of the group can be modified as well as
refreshing the group traffic protection keys and updating the Policy
Token.
This field is also specified as a sequence of protocols that will be
used by the GC/KS.
Colegrove & Harney Standards Track [Page 7]
RFC 4534 Group Security Policy Token v1 June 2006
3.4. Group Data Policy
The Data SA is the ultimate consumer of the group keys. The data
field will indicate the keys and mechanisms that are to be used in
communications between group members. There are several protocols
that could make use of group keys, ranging from simple security
applications that only need key for encryption and/or integrity
protection to more complex configurable security protocols such as
IPsec and Secure Real-time Transport Protocol (SRTP) [RFC3711]. The
sequencing of the Data SA mechanisms are from "inside" to "outside".
That is, the first Data SA defined in a policy token must act on the
raw data. Any Data SA specified after that will be applied in turn.
DataProtocol ::= Protocol
4. Security Considerations
This document specifies the structure for a group policy token. As
such, the structure as received by a group entity must be verifiably
authentic. This policy token uses CMS to apply authentication
through digital signatures. The security of this scheme relies upon
a secure CMS implementation, choice of signature mechanism of
appropriate strength for the group using the policy token, and
secure, sufficiently strong keys. Additionally, it relies upon
knowledge of a well-known Group Owner as the root of policy
enforcement.
Furthermore, while the Group Owner may list alternate mechanisms for
various functions, the group is only as strong as the weakest
accepted mechanisms. As such, the Group Owner is responsible for
providing only acceptable security mechanisms.
5. IANA Considerations
The following object identifiers have been assigned:
- id-ct-msec-token OBJECT IDENTIFIER ::= 1.3.6.1.5.5.12.1.1
- id-securitySuiteOne OBJECT IDENTIFIER ::= 1.3.6.1.5.5.12.2.1
- id-GSAKMPv1RegistrationProtocol
OBJECT IDENTIFIER::= 1.3.6.1.5.5.12.3.1
- id-GSAKMPv1DeRegistrationProtocol
OBJECT IDENTIFIER::= 1.3.6.1.5.5.12.3.2
- id-GSAKMPv1Rekey OBJECT IDENTIFIER::= 1.3.6.1.5.5.12.3.3
Colegrove & Harney Standards Track [Page 8]
RFC 4534 Group Security Policy Token v1 June 2006
- id-rekeyNone OBJECT IDENTIFIER ::= 1.3.6.1.5.5.12.4.1
- id-rekeyMethodGSAKMPLKH
OBJECT IDENTIFIER ::= 1.3.6.1.5.5.12.4.2
- id-reliabilityNone OBJECT IDENTIFIER ::= 1.3.6.1.5.5.12.5.1
- id-reliabilityResend OBJECT IDENTIFIER ::= 1.3.6.1.5.5.12.5.2
- id-reliabilityPost OBJECT IDENTIFIER ::= 1.3.6.1.5.5.12.5.3
- id-subGCKSSchemeNone OBJECT IDENTIFIER ::= 1.3.6.1.5.5.12.6.1
- id-subGCKSSchemeAutonomous
OBJECT IDENTIFIER ::= 1.3.6.1.5.5.12.6.2
- id-genericDataSA OBJECT IDENTIFIER ::= 1.3.6.1.5.5.12.7.1
The Group Security Policy Token can be extended through
specification. Extensions in the form of objects can be registered
through IANA. Extensions requiring changes to the protocol structure
will require an update to the tokenDefVersion field of the TokenID
(see Section 3.1).
6. References
6.1. Normative References
[RFC4535] Harney, H., Meth, U., Colegrove, A., and G. Gross, "GSAKMP:
Group Secure Association Key Management Protocol", RFC
4535, June 2006.
[RFC3280] Housley, R., Polk, W., Ford, W., and D. Solo, "Internet
X.509 Public Key Infrastructure Certificate and Certificate
Revocation List (CRL) Profile", RFC 3280, April 2002.
[RFC3852] Housley, R., "Cryptographic Message Syntax (CMS)", RFC
3852, July 2004.
[X.208] Recommendation X.208, Specification of Abstract Syntax
Notation One (ASN.1), 1988.
[X.660] Recommendation X.660, Information Technology ASN.1 Encoding
Rules: Specification of Basic Encoding Rules (BER),
Canonical Encoding Rules (CER), and Distinguished Encoding
Rules (DER), 1997.
Colegrove & Harney Standards Track [Page 9]
RFC 4534 Group Security Policy Token v1 June 2006
6.2. Informative References
[HCLM00] Harney, H., Colegrove, A., Lough, P., and U. Meth, "GSAKMP
Token Specification", Work in Progress, February 2003.
[RFC3711] Baugher, M., McGrew, D., Naslund, M., Carrara, E., and K.
Norrman, "The Secure Real-time Transport Protocol (SRTP)",
RFC 3711, March 2004.
[RFC3740] Hardjono, T. and B. Weis, "The Multicast Group Security
Architecture", RFC 3740, March 2004.
[HCM01] H. Harney, A. Colegrove, P. McDaniel, "Principles of Policy
in Secure Groups", Proceedings of Network and Distributed
Systems Security 2001 Internet Society, San Diego, CA,
February 2001.
[HHMCD01] Hardjono, T., Harney, H., McDaniel, P., Colegrove, A., and
P. Dinsmore, "Group Security Policy Token: Definition and
Payloads", Work in Progress, August 2003.
7. Acknowledgements
The following individuals deserve recognition and thanks for their
contributions, which have greatly improved this specification: Uri
Meth, whose knowledge of GSAKMP and tokens was greatly appreciated as
well as his help in getting this document submitted; Peter Lough,
Thomas Hardjono, Patrick McDaniel, and Pete Dinsmore for their work
on earlier versions of policy tokens; George Gross for the impetus to
have a well-specified, extensible policy token; and Rod Fleischer for
catching implementation issues.
The following technical works influenced the design of the Group
Security Policy Token: [HCLM00], [HCM01], and [HHMCD01]
Colegrove & Harney Standards Track [Page 10]
RFC 4534 Group Security Policy Token v1 June 2006
Appendix A. Core Policy Token ASN.1 Module
PolicyToken
{1.3.6.1.5.5.12.0.1}
DEFINITIONS IMPLICIT TAGS ::=
BEGIN
Token ::= SEQUENCE {
tokenInfo TokenID,
registration SEQUENCE OF Registration,
rekey SEQUENCE OF GroupMngmtProtocol,
data SEQUENCE OF DataProtocol
}
------------------------------------------------------------
-- Token ID
TokenID ::= SEQUENCE {
tokenDefVersion INTEGER (1), -- Group Security Policy Token v1
groupName OCTET STRING,
edition INTEGER OPTIONAL
}
LifeDate ::= CHOICE {
gt GeneralizedTime,
utc UTCTime,
interval INTEGER
}
------------------------------------------------------------
-- Registration
Registration ::= SEQUENCE {
register GroupMngmtProtocol,
de-register GroupMngmtProtocol
}
------------------------------------------------------------
-- GroupMngmtProtocol
GroupMngmtProtocol ::= CHOICE {
none NULL,
supported Protocol
}
Colegrove & Harney Standards Track [Page 11]
RFC 4534 Group Security Policy Token v1 June 2006
Protocol ::= SEQUENCE {
protocol OBJECT IDENTIFIER,
protocolInfo OCTET STRING
}
------------------------------------------------------------
-- DataProtocol
DataProtocol ::= Protocol
------------------------------------------------------------
END
Colegrove & Harney Standards Track [Page 12]
RFC 4534 Group Security Policy Token v1 June 2006
Appendix B. GSAKMPv1 Base Policy
This appendix provides the data structures needed for when GSAKMP
exchanges are used as the GroupMngmtProtocol for the registration,
de-registration, and/or Rekey SAs. This GSAKMP Base Policy
specification assumes familiarity with GSAKMP.
B.1. GSAKMPv1 Registration Policy
When GSAKMP is used in the Group Management Protocol for
registration, the following object identifier is used in the core
token.
id-GSAKMPv1RegistrationProtocol
OBJECT IDENTIFIER::= {1.3.6.1.5.5.12.3.1}
The registration policy for GSAKMP provides 1) information on
authorizations for group roles, 2) access control information for
group members, 3) the mechanisms used in the registration process,
and 4) information on what transport the GSAKMP registration exchange
will use.
GSAKMPv1RegistrationInfo ::= SEQUENCE {
joinAuthorization JoinAuthorization,
joinAccessControl SEQUENCE OF AccessControl,
joinMechanisms JoinMechanisms,
transport Transport
}
B.1.1. Authorization
joinAuthorization provides information on who is allowed to be a
Group Controller Key Server (GC/KS) and a sub-GC/KS. It also can
indicate if there are limitations on who can send data in a
group.
JoinAuthorization ::= SEQUENCE {
gCKS GCKSName,
subGCKS SEQUENCE OF GCKSName OPTIONAL,
senders SenderAuthorization
}
The authorization information is in the form of an access control
list indicating entity name and acceptable certification authority
information for the entity's certificate.
GCKSName ::= SEQUENCE OF UserCAPair
Colegrove & Harney Standards Track [Page 13]
RFC 4534 Group Security Policy Token v1 June 2006
UserCAPair ::= SEQUENCE {
groupEntity GSAKMPID,
cA CertAuth
}
groupEntity is defined by type and value. The types are indicated by
integers that correspond to the GSAKMP Identification types.
When a portion of a defined name type is filled with an "*", this
indicates a wildcard, representing any valid choice for a field.
This allows the specification of an authorization rule that is a
set of related names.
GSAKMPID ::= SEQUENCE {
typeValue INTEGER,
typeData OCTET STRING
}
The certificate authority is identified by the X.509 [RFC3280] key
identifier.
CertAuth ::= KeyIdentifier
Senders within a group either can be all (indicating no sender
restrictions) or can be an explicit list of those members authorized
to send data.
SenderAuthorization ::= CHOICE {
all [0] NULL,
limited [1] EXPLICIT SEQUENCE OF UserCAPair
}
B.1.2. AccessControl
joinAccessControl provides information on who is allowed to be a
Group Member. The access control list is implemented as a set of
permissions that the member must satisfy and a list of name rules
and the certificate authority that each must satisfy.
Additionally, a list of exclusions to the list may be provided.
AccessControl ::= SEQUENCE {
permissions [1] EXPLICIT SEQUENCE OF Permission OPTIONAL,
accessRule [2] EXPLICIT SEQUENCE OF UserCAPair,
exclusionsRule [3] EXPLICIT SEQUENCE OF UserCAPair OPTIONAL
}
The permissions initially available are an abstract set of numeric
levels that may be interpreted internal to a community.
Colegrove & Harney Standards Track [Page 14]
RFC 4534 Group Security Policy Token v1 June 2006
Permission ::= CHOICE {
simplePermission [1] SimplePermission
}
SimplePermission ::= ENUMERATED {
one(1),
two(2),
three(3),
four(4),
five(5),
six(6),
seven(7),
eight(8),
nine(9)
}
B.1.3. JoinMechanisms
Allowable GSAKMP mechanism choices for a particular group are
specified in joinMechanisms. Any set of JoinMechanism is acceptable
from a policy perspective.
JoinMechanisms ::= SEQUENCE OF JoinMechanism
Each set of mechanisms used in the GSAKMP Registration may be
specified either as an explicitly defined set or as a pre-defined
security suite.
JoinMechanism ::= CHOICE {
alaCarte [0] Mechanisms,
suite [1] SecuritySuite
}
B.1.3.1. alaCarte
In an explicitly defined -- or alaCarte -- set, a mechanism is
defined for the signature, the key exchange algorithm, the key
wrapping algorithm, the type of acknowledgement data, and
configuration data for the setting of timeouts.
Mechanisms ::= SEQUENCE {
signatureDef SigDef,
kEAlg KEAlg,
keyWrap KeyWrap,
ackData AckData,
opInfo OpInfo
}
Colegrove & Harney Standards Track [Page 15]
RFC 4534 Group Security Policy Token v1 June 2006
The signature definition requires specification of the signature
algorithm for message signing. The INTEGER that defines the choice
corresponds to the GSAKMP Signature type.
SigDef ::= SEQUENCE {
sigAlgorithmID INTEGER,
hashAlgorithmID INTEGER
}
The INTEGER corresponding to hashAlgorithm will map to the GSAKMP
Nonce Hash type values. This algorithm is used in computing the
combined nonce.
The key exchange algorithm requires an integer to define the GSAKMP
key creation type and may require additional per type data.
KEAlg ::= SEQUENCE {
keyExchangeAlgorithmID INTEGER,
keyExchangeAlgorithmData OCTET STRING OPTIONAL
}
The keyWrap is the algorithm that is used to wrap the group key(s)
and the policy token (if included). The integer corresponds to the
GSAKMP encryption type.
KeyWrap ::= INTEGER
Data may potentially be returned in a GSAKMP Key Download ACK/Failure
message. The type of data required by a group is specified by
AckData. No such field is currently supported or required.
AckData ::= CHOICE {
none [0] NULL
}
OpInfo provides configuration data for the operation of GSAKMP
registration. timeOut indicates the elapsed amount of time
before a sent message is considered to be misrouted or lost. It
is specified as the timestamp type LifeDate, previously defined
in the core token. terse informs a GC/KS whether the group
should be operated in terse (TRUE) or verbose (FALSE) mode. The
optional timestamp field indicates whether a timestamp (TRUE) or
a nonce (FALSE) is used for anti-replay protection. If the field
is absent, the use of nonces is the default mode for GSAKMP
registration.
Colegrove & Harney Standards Track [Page 16]
RFC 4534 Group Security Policy Token v1 June 2006
OpInfo ::= SEQUENCE {
timeOut LifeDate,
terse BOOLEAN,
timestamp BOOLEAN OPTIONAL
}
B.1.3.2. suite
If the choice of mechanism for the join is a predefined security
suite, then it is identified by OBJECT IDENTIFIER (OID). Other
security suites may be defined elsewhere by specification and
registration of an OID.
SecuritySuite ::= OBJECT IDENTIFIER
The OID for security suite 1, as defined within the GSAKMPv1
specification, is
id-securitySuiteOne OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.2.1}
B.1.4. Transport
transport indicates what protocol GSAKMP should ride over. The
choice of udpRTJtcpOther indicates that the GSAKMP Request to
Join message is carried by UDP and all other group establishment
messages are carried by TCP.
Transport ::= CHOICE {
tcp [0] NULL,
udp [1] NULL,
udpRTJtcpOther [2] NULL
}
B.2. GSAKMPv1 Registration ASN.1 Module
GSAKMPv1RegistrationSA
{1.3.6.1.5.5.12.0.2}
DEFINITIONS IMPLICIT TAGS ::=
BEGIN
EXPORTS
GCKSName;
IMPORTS
LifeDate
FROM PolicyToken {1.3.6.1.5.5.12.0.1}
Colegrove & Harney Standards Track [Page 17]
RFC 4534 Group Security Policy Token v1 June 2006
KeyIdentifier
FROM PKIX1Implicit88 { iso(1) identified-organization(3)
dod(6) internet(1) security(5) mechanisms(5) pkix(7)
id-mod(0) id-pkix1-implicit(19) };
id-GSAKMPv1RegistrationProtocol
OBJECT IDENTIFIER::= {1.3.6.1.5.5.12.7}
GSAKMPv1RegistrationInfo ::= SEQUENCE {
joinAuthorization JoinAuthorization,
joinAccessControl SEQUENCE OF AccessControl,
joinMechanisms JoinMechanisms,
transport Transport
}
JoinAuthorization ::= SEQUENCE {
gCKS GCKSName,
subGCKS SEQUENCE OF GCKSName OPTIONAL,
senders SenderAuthorization
}
GCKSName ::= SEQUENCE OF UserCAPair
UserCAPair ::= SEQUENCE {
groupEntity GSAKMPID,
cA CertAuth
}
CertAuth ::= KeyIdentifier
SenderAuthorization ::= CHOICE {
all [0] NULL,
limited [1] EXPLICIT SEQUENCE OF UserCAPair
}
AccessControl ::= SEQUENCE {
permissions [1] EXPLICIT SEQUENCE OF Permission OPTIONAL,
accessRule [2] EXPLICIT SEQUENCE OF UserCAPair,
exclusionsRule [3] EXPLICIT SEQUENCE OF UserCAPair OPTIONAL
}
Permission ::= CHOICE {
simplePermission [1] SimplePermission
}
Colegrove & Harney Standards Track [Page 18]
RFC 4534 Group Security Policy Token v1 June 2006
SimplePermission ::= ENUMERATED {
one(1),
two(2),
three(3),
four(4),
five(5),
six(6),
seven(7),
eight(8),
nine(9)
}
GSAKMPID ::= SEQUENCE {
typeValue INTEGER,
typeData OCTET STRING
}
JoinMechanisms ::= SEQUENCE OF JoinMechanism
JoinMechanism ::= CHOICE {
alaCarte [0] Mechanisms,
suite [1] SecuritySuite
}
Mechanisms ::= SEQUENCE {
signatureDef SigDef,
kEAlg KEAlg,
keyWrap KeyWrap,
ackData AckData,
opInfo OpInfo
}
SecuritySuite ::= OBJECT IDENTIFIER
-- SECURITY SUITE ONE --
id-securitySuiteOne OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.2.1}
SigDef ::= SEQUENCE {
sigAlgorithmID INTEGER,
hashAlgorithmID INTEGER
}
KEAlg ::= SEQUENCE {
keyExchangeAlgorithmID INTEGER,
keyExchangeAlgorithmData OCTET STRING OPTIONAL
}
KeyWrap ::= INTEGER
Colegrove & Harney Standards Track [Page 19]
RFC 4534 Group Security Policy Token v1 June 2006
AckData ::= CHOICE {
none [0] NULL
}
OpInfo ::= SEQUENCE {
timeOut LifeDate,
terse BOOLEAN,
timestamp BOOLEAN OPTIONAL
}
Transport ::= CHOICE {
tcp [0] NULL,
udp [1] NULL,
udpRTJtcpOther [2] NULL
}
END
B.3. GSAKMPv1 De-Registration Policy
GSAKMP de-registration provides a method to notify a (S-)GC/KS that a
member needs to leave a group. When GSAKMP is the de-registration
Protocol for the Group, the following object identifier is used in
the core token.
id-GSAKMPv1DeRegistrationProtocol OBJECT IDENTIFIER::=
{1.3.6.1.5.5.12.3.2}
The de-registration policy provides the mechanisms needed for the
de-registration exchange messages, an indication of whether the
exchange is to be done using terse (TRUE) or verbose (FALSE) mode,
and the transport used for the GSAKMP de-registration messages.
GSAKMPv1DeRegistrationInfo ::= SEQUENCE {
leaveMechanisms SEQUENCE OF LeaveMechanisms,
terse BOOLEAN,
transport Transport
}
The policy dictating the mechanisms needed for the de-registration
exchange is defined by leaveMechanisms. This field is specified as
LeaveMechanisms ::= SEQUENCE {
sigAlgorithm INTEGER,
hashAlgorithm INTEGER,
cA KeyIdentifier
}
Colegrove & Harney Standards Track [Page 20]
RFC 4534 Group Security Policy Token v1 June 2006
The INTEGER corresponding to sigAlgorithm will map to the GSAKMP
Signature type values. This algorithm set is to be used for message
signing.
The INTEGER corresponding to hashAlgorithm will map to the GSAKMP
Nonce Hash type values. This algorithm is used in computing the
combined nonce.
cA represents a trust point off of which the signer's certificate
must certify. It is identified by the Public Key Infrastructure for
X.509 Certificates (PKIX) KeyIdentifier [RFC3280] type.
transport will provide the expected transport for GSAKMP
de-registration messages. Initially, either UDP or TCP will be the
policy for a group.
Transport ::= CHOICE {
tcp [0] NULL,
udp [1] NULL
}
B.4. GSAKMPv1 De-Registration ASN.1 Module
GSAKMPv1DeRegistrationSA
{1.3.6.1.5.5.12.0.3}
DEFINITIONS IMPLICIT TAGS ::=
BEGIN
IMPORTS
KeyIdentifier
FROM PKIX1Implicit88 { iso(1) identified-organization(3)
dod(6) internet(1) security(5) mechanisms(5) pkix(7)
id-mod(0) id-pkix1-implicit(19) };
id-GSAKMPv1DeRegistrationProtocol
OBJECT IDENTIFIER::= {1.3.6.1.5.5.12.3.2}
GSAKMPv1DeRegistrationInfo ::= SEQUENCE {
leaveMechanisms SEQUENCE OF LeaveMechanisms,
transport Transport
}
Colegrove & Harney Standards Track [Page 21]
RFC 4534 Group Security Policy Token v1 June 2006
LeaveMechanisms ::= SEQUENCE {
sigAlgorithm INTEGER,
hashAlgorithm INTEGER,
cA KeyIdentifier
}
Transport ::= CHOICE {
tcp [0] NULL,
udp [1] NULL
}
END
B.5. GSAKMPv1 Rekey Policy
When GSAKMP is used as the Rekey Protocol for the Group, the
following object identifier should be used in the core token as the
rekey protocol:
id-GSAKMPv1Rekey OBJECT IDENTIFIER::= {1.3.6.1.5.5.12.0.4}
The GSAKMP rekey policy provides authorization information,
mechanisms for the GSAKMP rekey messages, indicators defining rekey
event definitions that define when the GC/KS should send a rekey
message, the protocol or method the rekey event will use, the rekey
interval that will allow a member to recognize a failure in the rekey
process, a reliability indicator that defines the method the rekey
will use to increase the likelihood of a rekey delivery (if any), and
finally an indication of how subordinate-GC/KSes will handle rekey.
This policy also describes the specific rekey policy methods "None"
and "GSAKMP LKH REKEY".
GSAKMPv1RekeyInfo ::= SEQUENCE {
authorization RekeyAuthorization,
mechanism RekeyMechanisms,
rekeyEventDef RekeyEventDef,
rekeyMethod RekeyMethod,
rekeyInterval LifeDate,
reliability Reliability,
subGCKSInfo SubGCKSInfo
}
B.5.1. Rekey Authorization
RekeyAuthorization ::= GCKSName
Colegrove & Harney Standards Track [Page 22]
RFC 4534 Group Security Policy Token v1 June 2006
B.5.2. Rekey Mechanisms
The policy dictating the mechanisms needed for rekey message
processing is defined by RekeyMechanisms. This field is specified as
RekeyMechanisms ::= SEQUENCE {
sigAlgorithm INTEGER,
hashAlgorithm INTEGER
}
The INTEGER corresponding to sigAlgorithm will map to the GSAKMP
Signature type values. This algorithm set is to be used for message
signing.
The INTEGER corresponding to hashAlgorithm will map to the GSAKMP
Nonce Hash type values. This algorithm is used in computing the
combined nonce.
B.5.3. Rekey Event Definition
Rekey Event Definition provides information to the GC/KS about the
system requirements for sending rekey messages. This allows
definition of the rekey event in time as well as event-driven
characteristics (a number of de-registration notifications as an
example), or a combination of the two (e.g., after x de-registrations
or 24 hours, whichever comes first).
RekeyEventDef ::= CHOICE {
none [0] NULL, -- never rekey
timeOnly [1] LifeDate, -- rekey every x units
event [2] INTEGER, -- rekey after x events
timeAndEvent [3] TimeAndEvent
}
The LifeDate specifies the maximum time a group should exist between
rekeys. This does not require clock synchronization as this is used
with respect to a local clock (a GC/KS clock for sending rekey
messages or a member clock for determining whether a message has been
missed).
The INTEGER corresponding to the event is an indicator of the number
of events a group should sustain before a rekey message is sent.
This defines the events between rekeys. An example of a relevant
event is de-registration notifications.
The TimeAndEvent is defined as a couple of the LifeDate and Integer
policies.
Colegrove & Harney Standards Track [Page 23]
RFC 4534 Group Security Policy Token v1 June 2006
TimeAndEvent ::= SEQUENCE {
time LifeDate, -- rekey after x units of time OR
event INTEGER -- x events occur
}
B.5.4. Rekey Methods
The rekey method defines the policy of how the rekey is to be
accomplished. This field is specified as
RekeyMethod ::= SEQUENCE {
rekeyMethodType OBJECT IDENTIFIER,
rekeyMethodInfo OCTET STRING
}
The rekeyMethodType will define the rekey method to be used by the
group.
The rekeyMethodInfo will supply the GMs with the information they
need to operate in the correct rekey mode.
B.5.4.1. Rekey Method NONE
The group defined to work without a rekey protocols supporting it is
supported by the rekeyMethodType NONE. There is no
RekeyMethodNoneInfo associated with this option.
id-rekeyNone OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.4.1}
RekeyMethodNoneInfo ::= NULL
B.5.4.2. Rekey Method GSAKMP LKH
The GSAKMP protocol specification defined an interpretation of the
Logical Key Hierarchy (LKH) protocol as a rekey method. This method
is supported by the following values.
id-rekeyMethodGSAKMPLKH OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.4.2}
RekeyMethodGSAKMPLKHInfo ::= INTEGER
The GSAKMP LKH method requires a gsakmp type value for identifying
the cryptographic algorithm used to wrap the keys. This value maps
to the GSAKMP encryption type.
Colegrove & Harney Standards Track [Page 24]
RFC 4534 Group Security Policy Token v1 June 2006
B.5.5. Rekey Interval
Rekey interval defines the maximum delay the GM should see between
valid rekeys. This provides a means to ensure the GM is
synchronized, from a key management perspective, with the rest of the
group. It is defined as a time/date stamp.
B.5.6. Rekey Reliability
The rekey message in the GSAKMP protocol is a single push message.
There are reliability concerns with such non-acknowledged messages
(i.e., message exchange). The Reliability policy defines the
mechanism used to deal with these concerns.
Reliability ::= SEQUENCE {
reliabilityMechanism OBJECT IDENTIFIER,
reliabilityMechContent OCTET STRING
}
The reliability mechanism is defined by an OBJECT IDENTIFIER and the
information needed to operate that mechanism is defined as
reliabilityMechContent and is an OCTET STRING (as before).
B.5.6.1. Rekey Reliability Mechanism None
In networks with adequate reliability, it may not be necessary to use
a mechanism to improve reliability of the rekey message. For these
networks the ReliabilityMechanism NONE is appropriate.
id-reliabilityNone OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.5.1}
ReliabilityContentNone ::= NULL
B.5.6.2. Rekey Reliability Mechanism Resend
In networks with unknown or questionable reliability, it may be
necessary to use a mechanism to improve reliability of the Rekey
Message. For these networks, the ReliabilityMechanism RESEND is
potentially appropriate. This mechanism has the GC/KS repeatedly
sending out the same message.
id-reliabilityResend OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.5.2}
ReliabilityResendInfo ::= INTEGER
The INTEGER value in the ReliabilityResendInfo indicates the number
of times the message should be resent.
Colegrove & Harney Standards Track [Page 25]
RFC 4534 Group Security Policy Token v1 June 2006
B.5.6.3. Rekey Reliability Mechanism Post
Another reliability mechanism is to post the rekey message on some
service that will make it generally available. This is the
reliabilityPost method.
id-reliabilityPost OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.5.3}
ReliabilityContentPost ::= IA5String
The IA5String associated with ReliabilityPost is the identifier of
the posting site and rekey message.
B.5.7. Distributed Operation Policy
The policy dictating the relationships between GC/KS and S-GC/KS for
distributed operations is defined as SubGCKSInfo. It is defined as a
couple of a subGCKSScheme and some information relating to that
Scheme in sGCKSContent.
SubGCKSInfo ::= SEQUENCE {
subGCKSScheme OBJECT IDENTIFIER,
sGCKSContent OCTET STRING
}
B.5.7.1. No Distributed Operation
If the group is not to use S-GC/KS, then that Scheme would be
SGCKSSchemeNone.
id-subGCKSSchemeNone OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.6.1}
SGCKSNoneContent ::= NULL
B.5.7.2. Autonomous Distributed Mode
If the group is to use S-GC/KS as defined in the GSAKMP specification
as Autonomous mode, then that scheme would be SGCKSAutonomous.
id-subGCKSSchemeAutonomous
OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.6.2}
SGCKSAutonomous ::= SEQUENCE {
authSubs GCKSName,
domain OCTET STRING OPTIONAL
}
Colegrove & Harney Standards Track [Page 26]
RFC 4534 Group Security Policy Token v1 June 2006
The policy information needed for autonomous mode is a list of
authorized S-GC/KSes and restrictions on who they may serve. The
domain field representing these restrictions is NULL for this
version.
B.6. GSAKMPv1 Rekey Policy ASN.1 Module
GSAKMPv1RekeySA
{1.3.6.1.5.5.12.0.4}
DEFINITIONS IMPLICIT TAGS ::=
BEGIN
IMPORTS
GCKSName
FROM GSAKMPv1RegistrationSA {1.3.6.1.5.5.12.0.2}
LifeDate
FROM PolicyToken {1.3.6.1.5.5.12.0.1};
id-GSAKMPv1Rekey OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.0.4}
GSAKMPv1RekeyInfo ::= SEQUENCE {
authorization RekeyAuthorization,
mechanism RekeyMechanisms,
rekeyEventDef RekeyEventDef, -- tells the GCKS when to rekey
rekeyMethod RekeyMethod,
rekeyInterval LifeDate, -- member knows when to rejoin
reliability Reliability, -- what mech will be used to
-- increase the likelihood
-- of rekey delivery
subGCKSInfo SubGCKSInfo -- what subordinate GCKS needs
}
RekeyAuthorization ::= GCKSName
RekeyMechanisms ::= SEQUENCE {
sigAlgorithm INTEGER,
hashAlgorithm INTEGER
}
RekeyEventDef ::= CHOICE {
none [0] NULL, -- never rekey
timeOnly [1] EXPLICIT LifeDate, -- rekey every x units
event [2] INTEGER, -- rekey after x events
timeAndEvent [3] TimeAndEvent
}
Colegrove & Harney Standards Track [Page 27]
RFC 4534 Group Security Policy Token v1 June 2006
TimeAndEvent ::= SEQUENCE {
time LifeDate, -- rekey after x units of time OR
event INTEGER -- x events occur
}
RekeyMethod ::= SEQUENCE {
rekeyMethodType OBJECT IDENTIFIER,
rekeyMethodInfo OCTET STRING
}
-- REKEY METHOD NONE --
id-rekeyNone OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.4.1}
RekeyMethodNoneInfo ::= NULL
-- REKEY METHOD GSAKMP LKH --
id-rekeyMethodGSAKMPLKH OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.4.2}
RekeyMethodGSAKMPLKHInfo ::= INTEGER -- gsakmp type value for
-- wrapping mechanism
Reliability ::= SEQUENCE {
reliabilityMechanism OBJECT IDENTIFIER,
reliabilityMechContent OCTET STRING
}
-- RELIABILITY MECHANISM NONE --
id-reliabilityNone OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.5.1}
ReliabilityContentNone ::= NULL
-- RELIABILITY MECHANISM RESEND --
id-reliabilityResend OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.5.2}
ReliabilityResendInfo ::= INTEGER -- # of times rekey message should
-- be resent
-- RELIABILITY MECHANISM POST --
id-reliabilityPost OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.5.3}
ReliabilityContentPost ::= IA5String
Colegrove & Harney Standards Track [Page 28]
RFC 4534 Group Security Policy Token v1 June 2006
SubGCKSInfo ::= SEQUENCE {
subGCKSScheme OBJECT IDENTIFIER,
sGCKSContent OCTET STRING
}
id-subGCKSSchemeNone OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.6.1}
SGCKSNoneContent ::= NULL
id-subGCKSSchemeAutonomous OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.6.2}
SGCKSAutonomous ::= SEQUENCE {
authSubs GCKSName,
domain OCTET STRING OPTIONAL
}
END
Colegrove & Harney Standards Track [Page 29]
RFC 4534 Group Security Policy Token v1 June 2006
Appendix C. Data SA Policy
The Data SA provides the data structures needed for the protection
of the data exchanged between group members. This appendix defines
the data structures needed for a simple, generic security application
making use of fixed security mechanisms. Such a Data SA requires
only that keys delivered by the registration and rekey protocols be
mapped to the service using them.
C.1. Generic Data Policy
The Generic Data Policy has the following identifier:
id-genericDataSA OBJECT IDENTIFIER :: = {1.3.6.1.5.5.12.7.1}
If an authentication mechanism is used within the security
application, the key identifier (kMKeyID) used in the key management
protocol is given, as well as an optional key expiration date.
Likewise, if an encryption mechanism is used within the security
application, the encryption key identifier is given, as well as an
optional key expiration date (keyExpirationDate).
GenericDataSAInfo ::= SEQUENCE {
authentication [0] EXPLICIT KeyInfo OPTIONAL,
encryption [1] EXPLICIT KeyInfo OPTIONAL
}
KeyInfo ::= SEQUENCE{
kMKeyID OCTET STRING,
keyExpirationDate LifeDate OPTIONAL
}
C.2. Generic Data Policy ASN.1 Module
GenericDataSA
{1.3.6.1.5.5.12.0.5}
DEFINITIONS IMPLICIT TAGS ::=
BEGIN
-- DATA APPLICATION: Generic
-- This token specification is for data applications with
-- fixed security mechanisms. Such data applications only
-- need a mapping of management protocol key identification
-- tags to security service.
Colegrove & Harney Standards Track [Page 30]
RFC 4534 Group Security Policy Token v1 June 2006
IMPORTS
LifeDate
FROM PolicyToken {1.3.6.1.5.5.12.0.1}
KeyIdentifier
FROM PKIX1Implicit88 { iso(1) identified-organization(3)
dod(6) internet(1) security(5) mechanisms(5) pkix(7)
id-mod(0) id-pkix1-implicit(19) };
id-genericDataSA OBJECT IDENTIFIER ::= {1.3.6.1.5.5.12.7.1}
GenericDataSAInfo ::= SEQUENCE {
authentication [0] EXPLICIT KeyInfo OPTIONAL,
encryption [1] EXPLICIT KeyInfo OPTIONAL
}
KeyInfo ::= SEQUENCE{
kMKeyID OCTET STRING,
keyExpirationDate LifeDate OPTIONAL
}
END
Colegrove & Harney Standards Track [Page 31]
RFC 4534 Group Security Policy Token v1 June 2006
Authors' Addresses
Andrea Colegrove
SPARTA, Inc.
7110 Samuel Morse Drive
Columbia, MD 21046
Phone: (443) 430-8014
Fax: (443) 430-8163
EMail: acc@sparta.com
Hugh Harney
SPARTA, Inc.
7110 Samuel Morse Drive
Columbia, MD 21046
Phone: (443) 430-8032
Fax: (443) 430-8181
EMail: hh@sparta.com
Colegrove & Harney Standards Track [Page 32]
RFC 4534 Group Security Policy Token v1 June 2006
Full Copyright Statement
Copyright (C) The Internet Society (2006).
This document is subject to the rights, licenses and restrictions
contained in BCP 78, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Acknowledgement
Funding for the RFC Editor function is provided by the IETF
Administrative Support Activity (IASA).
Colegrove & Harney Standards Track [Page 33]