Projects/KerberosDelegationACL

This is an early stage project for MIT Kerberos. It is being fleshed out by its proponents. Feel free to help flesh out the details of this project. After the project is ready, it will be presented for review and approval.

Background

Customers would like greater access controls for constrained delegation. The current implementation provides ACLs for S4U2Proxy requests to restrict which target services the KDC can issue for proxy principals, but does not have provisions for which user principals that the proxy principal can request service tickets on behalf of.

Design

The proposed solution is implemented in the LDAP back-end only. The proposed attributes and classes are:

attributeTypes: ( <OID to be under KIT>
        NAME 'memberPrincipal'
        DESC 'Principal names member of a groupOfPrincipals group'
        EQUALITY caseExactIA5Match
        SUBSTR caseExactSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.26)

objectClasses: ( <OID to be under KIT>
        NAME 'groupOfPrincipals'
        SUP top AUXILIARY
        MUST ( cn )
        MAY ( memberPrincipal ))

attributeTypes: ( <OID to be under KIT>
         NAME 'AllowToImpersonate'
         DESC 'Principals that can be impersonated'
         SUP distinguishedName)

attributeTypes: ( <OID to be under KIT>
         NAME 'AllowedTarget'
         DESC 'Target principals alowed to get a ticket for'
         SUP distinguishedName)

objectClasses: ( <OID to be under KIT>
        NAME 'Krb5DelegationACL'
        SUP groupOfPrincipals STRUCTURAL
        MAY ( AllowToImpersonate $ AllowedTarget ))

Groupings are proposed given that one instance could be used across multiple entries instead of having to define these multiple times for each entry.

groupOfPrincipals is first created (which may contain a single principal) for clients and targets, and then joining all together into an 'ACL object'.

Note that in the schema, lack of AllowToImpersonate means ALL clients can be impersonated. This may not be adhere to conservative security practices, but is in line with the general behavior for constrained delegation access, has better usability, and performance. We haven't implemented it yet, but also you could have regexes in memberPrincipal for additional flexibility.

This schema allows us to resolve the ACL using a single LDAP query (if your LDAP server supports the dereference control). The implementation could try the dereference control query first and then fall-back to a join control query after the first query fails.

We find this schema was the optimal compromise between the flexibility we needed and the complexity we wanted to allow, and simpler ones would prevent us from doing what's needed in a useful manner.

The only drawback is that you cannot fit this into kadmin as it is, because it requires to be able to represent grouping mechanism and ACL objects, it would be nice if kadmin could be extended so that it is flexible enough to allow this kind of representation.

Use Cases

The main use case is to restrict which user principals are allowed to be impersonated by the proxy principal for the target service principal. Administrators that want to limit access to certain users for target services can use the ACL design without needing to update target service applications/systems to use interpret authorization data. This assumes a non-cross realm environment.

This use case can be expanded to allow for a set of multiple users to be impersonated by a set of proxy principals for a set of target principals. This is accomplished with out having to maintain separate ACL lists for various target services by using groupings similar to network groups.

Potential Conflicts with Existing Implementations

The closest functionality to Kerberos Delegation ACLs can be found in Windows 2012. This configuration can be accomplished in Windows by setting the PrincipalsAllowedToDelegateToAccount attribute to the proxy services for the target services. The following procedures gives an example on how this is accomplished:

---begin procedures---

In regards to Windows Server 2012: The "Delegation" tab is still present through the AD Users and Computers interface, but has the traditional behavior of the front-end selecting which resource services it can delegate to, instead of selecting which front-end services can delegate to the resource service. The security tab is not present in the AD Users and Computers interface, but rather through the AD Administrative Center. So to emulate the functionality of the Delegation ACL (using the same actors as described in the KerberosDelegationACL project page), in the AD environment:

1. Create a group "allowed-users" with "shawn@KERBEROS.ORG" and "simo@KERBEROS.ORG" as members.
2. Select "ldap-server-1"s and "ldap-server-2"s security tab and add "allowed-users".
3. Create another group "http-ldap-delegation" with "HTTP/http-proxy-1.kerberos.org@KERBEROS.ORG", "HTTP/http-proxy-2.kerberos.org@KERBEROS.ORG", and "HTTP/http-proxy-3.kerberos.org@KERBEROS.ORG" as members.
4. Then restrict the delegation group to the resource with the following invocation:
   set-adcomputer ldap-server-1 -PrincipalsAllowedToDelegateToAccount http-ldap-delegation
   set-adcomputer ldap-server-2 -PrincipalsAllowedToDelegateToAccount http-ldap-delegation

So above, the KDC will restrict the resource ticket issuance for S4U2Proxy requests to http-ldap-delegation. The user access to the resource will be controlled by the allowed-users group, which differs from the Kerberos Delegation ACL project by the fact that the authorization is performed by the application rather than enforced by the KDC. Note that the above should also be supported through x-realms.

---end procedures---

There a couple of benefits that the proposed project entails that justifies why having different implementations for somewhat similar functionality:

1. Policy decisions can be made by the KDC w/o having to rely on updating application servers to perform the policy enforcement against the user. 2. Bindings are/can be user-to-service controlled providing finer granular authorization to said services.

Documentation

Kerberos Delegation ACLs allow for fine-grained access controls for Services For Users to Proxy (S4U2Proxy) (i.e. Constrained Delegation) requests. This allows a set of users to have access to a specified set of services through set of proxy services. This binding is referenced during S4U2Proxy requests to determine if the KDC will accept or reject the client request. Currently this configuration is only supported when using LDAP as a backend to the KDC. The following documents how to configure an example ACL for S4U2Proxy requests:

We want to allow our HTTP server cluster to impersonate 2 users (shawn and simo) against the LDAP server cluster:

First we create a group of users:

dn: cn=allowed-users,dc=kerberos,dc=org
objectclass: groupOfPrincipals
cn: cn=allowed-users
memberPrincipal: shawn@KERBEROS.ORG
memberPrincipal: simo@KERBEROS.ORG

Then a group of target servers (we assume there may be multiple copies all equally accessible):

dn: cn=LDAP-Servers,dc=kerberos,dc=org
objectclass: groupOfPrincipals
cn: LDAP-Servers
memberPrincipal: ldap/ldap-server-1.kerberos.org@KERBEROS.ORG
memberPrincipal: ldap/ldap-server-2.kerberos.org@KERBEROS.ORG

Finally we create the allow rule which binds clients, targets, and the proxy service:

dn: cn=http-ldap-delegation,dc=kerberos,dc=org
objectclass: groupOfPrincipals
objectclass: Krb5DelegationACL
cn: http-ldap-delegation
AllowToImpersonate: cn=allowed-users,dc=kerberos,dc=org
AllowedTarget: cn=LDAP-Servers,kdc=kerberos,dc=org
memberPrincipal: HTTP/http-proxy-1.kerberos.org@KERBEROS.ORG
memberPrincipal: HTTP/http-proxy-2.kerberos.org@KERBEROS.ORG
memberPrincipal: HTTP/http-proxy-3.kerberos.org@KERBEROS.ORG

Testing

Currently the GSS-API test suite provides S4U test modules which could be expanded to include Kerberos Delegation ACL tests that tests both success and failure conditions:

Assertion: KDACL1