1 /* acl.c - routines to parse and check acl's */
4 * Copyright 1998-1999 The OpenLDAP Foundation, All Rights Reserved.
5 * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
14 #include <ac/socket.h>
15 #include <ac/string.h>
16 #include <ac/unistd.h>
20 static void split(char *line, int splitchar, char **left, char **right);
21 static void access_append(Access **l, Access *a);
22 static void acl_usage(void) LDAP_GCCATTR((noreturn));
25 static void print_acl(Backend *be, AccessControl *a);
26 static void print_access(Access *b);
30 regtest(const char *fname, int lineno, char *pat) {
46 for (size = 0, flag = 0; (size < sizeof(buf)) && *sp; sp++) {
48 if (*sp == '$'|| (*sp >= '0' && *sp <= '9')) {
65 if ( size >= (sizeof(buf)-1) ) {
67 "%s: line %d: regular expression \"%s\" too large\n",
72 if ((e = regcomp(&re, buf, REG_EXTENDED|REG_ICASE))) {
74 regerror(e, &re, error, sizeof(error));
76 "%s: line %d: regular expression \"%s\" bad because of %s\n",
77 fname, lineno, pat, error );
100 for ( i = 1; i < argc; i++ ) {
101 /* to clause - select which entries are protected */
102 if ( strcasecmp( argv[i], "to" ) == 0 ) {
105 "%s: line %d: only one to clause allowed in access line\n",
109 a = (AccessControl *) ch_calloc( 1, sizeof(AccessControl) );
110 a->acl_filter = NULL;
111 a->acl_dn_pat = NULL;
113 a->acl_access = NULL;
115 for ( ++i; i < argc; i++ ) {
116 if ( strcasecmp( argv[i], "by" ) == 0 ) {
121 if ( strcasecmp( argv[i], "*" ) == 0 ) {
122 if( a->acl_dn_pat != NULL ) {
124 "%s: line %d: dn pattern"
125 " already specified in to clause.\n",
130 a->acl_dn_pat = ch_strdup( "*" );
134 split( argv[i], '=', &left, &right );
136 if ( strcasecmp( left, "dn" ) == 0 ) {
137 if( a->acl_dn_pat != NULL ) {
139 "%s: line %d: dn pattern"
140 " already specified in to clause.\n",
145 if ( right == NULL ) {
147 "%s: line %d: missing \"=\" in \"%s\" in to clause\n",
148 fname, lineno, left );
152 if( *right == '\0' ) {
153 a->acl_dn_pat = ch_strdup("^$");
155 } else if ( strcmp(right, "*") == 0
156 || strcmp(right, ".*") == 0
157 || strcmp(right, ".*$") == 0
158 || strcmp(right, "^.*") == 0
159 || strcmp(right, "^.*$$") == 0
160 || strcmp(right, ".*$$") == 0
161 || strcmp(right, "^.*$$") == 0 )
163 a->acl_dn_pat = ch_strdup( "*" );
166 a->acl_dn_pat = ch_strdup( right );
172 if ( right == NULL || *right == '\0' ) {
174 "%s: line %d: missing \"=\" in (or value after) \"%s\" in to clause\n",
175 fname, lineno, left );
179 if ( strcasecmp( left, "filter" ) == 0 ) {
180 if ( (a->acl_filter = str2filter(
183 "%s: line %d: bad filter \"%s\" in to clause\n",
184 fname, lineno, right );
188 } else if ( strncasecmp( left, "attr", 4 ) == 0 ) {
191 alist = str2charray( right, "," );
192 charray_merge( &a->acl_attrs, alist );
193 charray_free( alist );
197 "%s: line %d: expecting <what> got \"%s\"\n",
198 fname, lineno, left );
203 if ( a->acl_dn_pat != NULL && strcmp(a->acl_dn_pat, "*") == 0) {
204 free( a->acl_dn_pat );
205 a->acl_dn_pat = NULL;
208 if( a->acl_dn_pat != NULL ) {
209 int e = regcomp( &a->acl_dn_re, a->acl_dn_pat,
210 REG_EXTENDED | REG_ICASE );
213 regerror( e, &a->acl_dn_re, buf, sizeof(buf) );
215 "%s: line %d: regular expression \"%s\" bad because of %s\n",
216 fname, lineno, right, buf );
221 /* by clause - select who has what access to entries */
222 } else if ( strcasecmp( argv[i], "by" ) == 0 ) {
225 "%s: line %d: to clause required before by clause in access line\n",
231 * by clause consists of <who> and <access>
234 b = (Access *) ch_calloc( 1, sizeof(Access) );
236 ACL_INVALIDATE( b->a_mask );
240 "%s: line %d: premature eol: expecting <who>\n",
246 for ( ; i < argc; i++ ) {
248 split( argv[i], '=', &left, &right );
250 if ( strcasecmp( argv[i], "*" ) == 0 ) {
251 pat = ch_strdup( "*" );
253 } else if ( strcasecmp( argv[i], "anonymous" ) == 0 ) {
254 pat = ch_strdup( "anonymous" );
256 } else if ( strcasecmp( argv[i], "self" ) == 0 ) {
257 pat = ch_strdup( "self" );
259 } else if ( strcasecmp( argv[i], "users" ) == 0 ) {
260 pat = ch_strdup( "users" );
262 } else if ( strcasecmp( left, "dn" ) == 0 ) {
263 if( right == NULL ) {
265 pat = ch_strdup( "users" );
267 } else if (*right == '\0' ) {
269 pat = ch_strdup( "anonymous" );
271 } else if ( strcmp( right, "*" ) == 0 ) {
273 /* any or users? any for now */
274 pat = ch_strdup( "users" );
276 } else if ( strcmp( right, ".+" ) == 0
277 || strcmp( right, "^.+" ) == 0
278 || strcmp( right, ".+$" ) == 0
279 || strcmp( right, "^.+$" ) == 0
280 || strcmp( right, ".+$$" ) == 0
281 || strcmp( right, "^.+$$" ) == 0 )
283 pat = ch_strdup( "users" );
285 } else if ( strcmp( right, ".*" ) == 0
286 || strcmp( right, "^.*" ) == 0
287 || strcmp( right, ".*$" ) == 0
288 || strcmp( right, "^.*$" ) == 0
289 || strcmp( right, ".*$$" ) == 0
290 || strcmp( right, "^.*$$" ) == 0 )
292 pat = ch_strdup( "*" );
295 regtest(fname, lineno, right);
296 pat = ch_strdup( right );
304 if( b->a_dn_pat != NULL ) {
306 "%s: line %d: dn pattern already specified.\n",
315 if ( strcasecmp( left, "dnattr" ) == 0 ) {
316 if( b->a_dn_pat != NULL ) {
318 "%s: line %d: dnattr already specified.\n",
323 #ifdef SLAPD_SCHEMA_NOT_COMPAT
324 b->a_dn_at = at_find( right );
326 if( b->a_dn_at == NULL ) {
328 "%s: line %d: dnattr attribute type undefined.\n",
333 #ifdef SLAPD_OID_DN_SYNTAX
334 if( strcmp( b->a_dn_at->sat_syntax_oid,
335 SLAPD_OID_DN_SYNTAX ) != 0 )
338 "%s: line %d: dnattr attribute type not of DN syntax.\n",
344 b->a_dn_at = ch_strdup( right );
349 if ( strncasecmp( left, "group", sizeof("group")-1 ) == 0 ) {
353 if( b->a_group_pat != NULL ) {
355 "%s: line %d: group pattern already specified.\n",
360 /* format of string is "group/objectClassValue/groupAttrName" */
361 if ((value = strchr(left, '/')) != NULL) {
364 && (name = strchr(value, '/')) != NULL)
370 regtest(fname, lineno, right);
371 b->a_group_pat = ch_strdup( right );
373 if (value && *value) {
374 b->a_group_oc = ch_strdup(value);
377 b->a_group_oc = ch_strdup("groupOfNames");
381 #ifdef SLAPD_SCHEMA_NOT_COMPAT
382 b->a_group_at = at_find( name );
384 b->a_group_at = ch_strdup(name);
389 #ifdef SLAPD_SCHEMA_NOT_COMPAT
390 b->a_group_at = at_find("member");
392 b->a_group_at = ch_strdup("member");
396 #ifdef SLAPD_SCHEMA_NOT_COMPAT
397 if( b->a_group_at == NULL ) {
399 "%s: line %d: group attribute type undefined.\n",
404 #ifdef SLAPD_OID_DN_SYNTAX
405 if( strcmp( b->a_group_at->sat_syntax_oid,
406 SLAPD_OID_DN_SYNTAX ) != 0 )
409 "%s: line %d: group attribute type not of DN syntax.\n",
413 #endif /* SLAPD_OID_DN_SYNTAX */
414 #endif /* SLAPD_SCHEMA_NOT_COMPAT */
418 if ( strcasecmp( left, "peername" ) == 0 ) {
419 if( b->a_peername_pat != NULL ) {
421 "%s: line %d: peername pattern already specified.\n",
426 regtest(fname, lineno, right);
427 b->a_peername_pat = ch_strdup( right );
431 if ( strcasecmp( left, "sockname" ) == 0 ) {
432 if( b->a_sockname_pat != NULL ) {
434 "%s: line %d: sockname pattern already specified.\n",
439 regtest(fname, lineno, right);
440 b->a_sockname_pat = ch_strdup( right );
444 if ( strcasecmp( left, "domain" ) == 0 ) {
445 if( b->a_domain_pat != NULL ) {
447 "%s: line %d: domain pattern already specified.\n",
452 regtest(fname, lineno, right);
453 b->a_domain_pat = ch_strdup( right );
457 if ( strcasecmp( left, "sockurl" ) == 0 ) {
458 if( b->a_sockurl_pat != NULL ) {
460 "%s: line %d: sockurl pattern already specified.\n",
465 regtest(fname, lineno, right);
466 b->a_sockurl_pat = ch_strdup( right );
470 #ifdef SLAPD_ACI_ENABLED
471 if ( strcasecmp( left, "aci" ) == 0 ) {
472 if( b->a_aci_at != NULL ) {
474 "%s: line %d: aci attribute already specified.\n",
479 #ifdef SLAPD_SCHEMA_NOT_COMPAT
480 if ( right != NULL && *right != '\0' ) {
481 b->a_aci_at = at_find( right );
483 b->a_aci_at = at_find( SLAPD_ACI_DEFAULT_ATTR );
486 if( b->a_aci_at == NULL ) {
488 "%s: line %d: aci attribute type undefined.\n",
493 if( strcmp( b->a_aci_at->sat_syntax_oid,
494 SLAPD_OID_ACI_SYNTAX ) != 0 )
497 "%s: line %d: aci attribute type not of ACI syntax.\n",
502 if ( right != NULL && *right != '\0' ) {
503 b->a_aci_at = ch_strdup( right );
505 b->a_aci_at = ch_strdup( SLAPD_ACI_DEFAULT_ATTR );
510 #endif /* SLAPD_ACI_ENABLED */
512 if( right != NULL ) {
519 if( i == argc || ( strcasecmp( left, "stop" ) == 0 )) {
520 /* out of arguments or plain stop */
522 ACL_PRIV_ASSIGN(b->a_mask, ACL_PRIV_ADDITIVE);
523 b->a_type = ACL_STOP;
525 access_append( &a->acl_access, b );
529 if( strcasecmp( left, "continue" ) == 0 ) {
532 ACL_PRIV_ASSIGN(b->a_mask, ACL_PRIV_ADDITIVE);
533 b->a_type = ACL_CONTINUE;
535 access_append( &a->acl_access, b );
539 if( strcasecmp( left, "break" ) == 0 ) {
542 ACL_PRIV_ASSIGN(b->a_mask, ACL_PRIV_ADDITIVE);
543 b->a_type = ACL_BREAK;
545 access_append( &a->acl_access, b );
549 if ( strcasecmp( left, "by" ) == 0 ) {
550 /* we've gone too far */
552 ACL_PRIV_ASSIGN(b->a_mask, ACL_PRIV_ADDITIVE);
553 b->a_type = ACL_STOP;
555 access_append( &a->acl_access, b );
560 if( strncasecmp( left, "self", 4 ) == 0 ) {
562 ACL_PRIV_ASSIGN( b->a_mask, str2accessmask( &left[4] ) );
565 ACL_PRIV_ASSIGN( b->a_mask, str2accessmask( left ) );
568 if( ACL_IS_INVALID( b->a_mask ) ) {
570 "%s: line %d: expecting <access> got \"%s\"\n",
571 fname, lineno, left );
575 b->a_type = ACL_STOP;
578 /* out of arguments or plain stop */
579 access_append( &a->acl_access, b );
583 if( strcasecmp( argv[i], "continue" ) == 0 ) {
585 b->a_type = ACL_CONTINUE;
587 } else if( strcasecmp( argv[i], "break" ) == 0 ) {
589 b->a_type = ACL_BREAK;
591 } else if ( strcasecmp( argv[i], "stop" ) != 0 ) {
596 access_append( &a->acl_access, b );
600 "%s: line %d: expecting \"to\" or \"by\" got \"%s\"\n",
601 fname, lineno, argv[i] );
606 /* if we have no real access clause, complain and do nothing */
609 "%s: line %d: warning: no access clause(s) specified in access line\n",
614 if (ldap_debug & LDAP_DEBUG_ACL)
618 if ( a->acl_access == NULL ) {
620 "%s: line %d: warning: no by clause(s) specified in access line\n",
625 acl_append( &be->be_acl, a );
627 acl_append( &global_acl, a );
633 accessmask2str( slap_access_mask_t mask, char *buf )
637 assert( buf != NULL );
639 if ( ACL_IS_INVALID( mask ) ) {
645 if ( ACL_IS_LEVEL( mask ) ) {
646 if ( ACL_LVL_IS_NONE(mask) ) {
647 strcat( buf, "none" );
649 } else if ( ACL_LVL_IS_AUTH(mask) ) {
650 strcat( buf, "auth" );
652 } else if ( ACL_LVL_IS_COMPARE(mask) ) {
653 strcat( buf, "compare" );
655 } else if ( ACL_LVL_IS_SEARCH(mask) ) {
656 strcat( buf, "search" );
658 } else if ( ACL_LVL_IS_READ(mask) ) {
659 strcat( buf, "read" );
661 } else if ( ACL_LVL_IS_WRITE(mask) ) {
662 strcat( buf, "write" );
664 strcat( buf, "unknown" );
670 if( ACL_IS_ADDITIVE( mask ) ) {
673 } else if( ACL_IS_SUBTRACTIVE( mask ) ) {
680 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_WRITE) ) {
685 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_READ) ) {
690 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_SEARCH) ) {
695 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_COMPARE) ) {
700 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_AUTH) ) {
705 if ( none && ACL_PRIV_ISSET(mask, ACL_PRIV_NONE) ) {
714 if ( ACL_IS_LEVEL( mask ) ) {
721 str2accessmask( const char *str )
723 slap_access_mask_t mask;
725 if( !isalpha(str[0]) ) {
728 if ( str[0] == '=' ) {
731 } else if( str[0] == '+' ) {
732 ACL_PRIV_ASSIGN(mask, ACL_PRIV_ADDITIVE);
734 } else if( str[0] == '-' ) {
735 ACL_PRIV_ASSIGN(mask, ACL_PRIV_SUBSTRACTIVE);
738 ACL_INVALIDATE(mask);
742 for( i=1; str[i] != '\0'; i++ ) {
743 if( TOLOWER(str[i]) == 'w' ) {
744 ACL_PRIV_SET(mask, ACL_PRIV_WRITE);
746 } else if( TOLOWER(str[i]) == 'r' ) {
747 ACL_PRIV_SET(mask, ACL_PRIV_READ);
749 } else if( TOLOWER(str[i]) == 's' ) {
750 ACL_PRIV_SET(mask, ACL_PRIV_SEARCH);
752 } else if( TOLOWER(str[i]) == 'c' ) {
753 ACL_PRIV_SET(mask, ACL_PRIV_COMPARE);
755 } else if( TOLOWER(str[i]) == 'x' ) {
756 ACL_PRIV_SET(mask, ACL_PRIV_AUTH);
758 } else if( str[i] != '0' ) {
759 ACL_INVALIDATE(mask);
767 if ( strcasecmp( str, "none" ) == 0 ) {
768 ACL_LVL_ASSIGN_NONE(mask);
770 } else if ( strcasecmp( str, "auth" ) == 0 ) {
771 ACL_LVL_ASSIGN_AUTH(mask);
773 } else if ( strcasecmp( str, "compare" ) == 0 ) {
774 ACL_LVL_ASSIGN_COMPARE(mask);
776 } else if ( strcasecmp( str, "search" ) == 0 ) {
777 ACL_LVL_ASSIGN_SEARCH(mask);
779 } else if ( strcasecmp( str, "read" ) == 0 ) {
780 ACL_LVL_ASSIGN_READ(mask);
782 } else if ( strcasecmp( str, "write" ) == 0 ) {
783 ACL_LVL_ASSIGN_WRITE(mask);
786 ACL_INVALIDATE( mask );
795 fprintf( stderr, "\n"
796 "<access clause> ::= access to <what> "
797 "[ by <who> <access> <control> ]+ \n"
798 "<what> ::= * | [dn=<regex>] [filter=<ldapfilter>] [attrs=<attrlist>]\n"
799 "<attrlist> ::= <attr> | <attr> , <attrlist>\n"
800 "<attr> ::= <attrname> | entry | children\n"
801 "<who> ::= [ * | anonymous | users | self | dn=<regex> ]\n"
802 "\t[dnattr=<attrname>]\n"
803 "\t[group[/<objectclass>[/<attrname>]]=<regex>]\n"
804 "\t[peername=<regex>] [sockname=<regex>]\n"
805 "\t[domain=<regex>] [sockurl=<regex>]\n"
806 #ifdef SLAPD_ACI_ENABLED
807 "\t[aci=<attrname>]\n"
809 "<access> ::= [self]{<level>|<priv>}\n"
810 "<level> ::= none | auth | compare | search | read | write\n"
811 "<priv> ::= {=|+|-}{w|r|s|c|x}+\n"
812 "<control> ::= [ stop | continue | break ]\n"
814 exit( EXIT_FAILURE );
826 if ( (*right = strchr( line, splitchar )) != NULL ) {
827 *((*right)++) = '\0';
832 access_append( Access **l, Access *a )
834 for ( ; *l != NULL; l = &(*l)->a_next )
841 acl_append( AccessControl **l, AccessControl *a )
843 for ( ; *l != NULL; l = &(*l)->acl_next )
850 access2str( slap_access_t access )
852 if ( access == ACL_NONE ) {
855 } else if ( access == ACL_AUTH ) {
858 } else if ( access == ACL_COMPARE ) {
861 } else if ( access == ACL_SEARCH ) {
864 } else if ( access == ACL_READ ) {
867 } else if ( access == ACL_WRITE ) {
875 str2access( const char *str )
877 if ( strcasecmp( str, "none" ) == 0 ) {
880 } else if ( strcasecmp( str, "auth" ) == 0 ) {
883 } else if ( strcasecmp( str, "compare" ) == 0 ) {
886 } else if ( strcasecmp( str, "search" ) == 0 ) {
889 } else if ( strcasecmp( str, "read" ) == 0 ) {
892 } else if ( strcasecmp( str, "write" ) == 0 ) {
896 return( ACL_INVALID_ACCESS );
902 print_access( Access *b )
904 char maskbuf[ACCESSMASK_MAXLEN];
906 fprintf( stderr, "\tby" );
908 if ( b->a_dn_pat != NULL ) {
909 if( strcmp(b->a_dn_pat, "*") == 0
910 || strcmp(b->a_dn_pat, "users") == 0
911 || strcmp(b->a_dn_pat, "anonymous") == 0
912 || strcmp(b->a_dn_pat, "self") == 0 )
914 fprintf( stderr, " %s", b->a_dn_pat );
917 fprintf( stderr, " dn=%s", b->a_dn_pat );
921 if ( b->a_dn_at != NULL ) {
922 fprintf( stderr, " dnattr=%s", b->a_dn_at );
925 if ( b->a_group_pat != NULL ) {
926 fprintf( stderr, " group: %s", b->a_group_pat );
928 if ( b->a_group_oc ) {
929 fprintf( stderr, " objectClass: %s", b->a_group_oc );
931 if ( b->a_group_at ) {
932 fprintf( stderr, " attributeType: %s", b->a_group_at );
937 if ( b->a_peername_pat != NULL ) {
938 fprintf( stderr, " peername=%s", b->a_peername_pat );
941 if ( b->a_sockname_pat != NULL ) {
942 fprintf( stderr, " sockname=%s", b->a_sockname_pat );
945 if ( b->a_domain_pat != NULL ) {
946 fprintf( stderr, " domain=%s", b->a_domain_pat );
949 if ( b->a_sockurl_pat != NULL ) {
950 fprintf( stderr, " sockurl=%s", b->a_sockurl_pat );
953 #ifdef SLAPD_ACI_ENABLED
954 if ( b->a_aci_at != NULL ) {
955 fprintf( stderr, " aci=%s", b->a_aci_at );
959 fprintf( stderr, " %s%s",
960 b->a_dn_self ? "self" : "",
961 accessmask2str( b->a_mask, maskbuf ) );
963 if( b->a_type == ACL_BREAK ) {
964 fprintf( stderr, " break" );
966 } else if( b->a_type == ACL_CONTINUE ) {
967 fprintf( stderr, " continue" );
969 } else if( b->a_type != ACL_STOP ) {
970 fprintf( stderr, " unknown-control" );
973 fprintf( stderr, "\n" );
978 print_acl( Backend *be, AccessControl *a )
983 fprintf( stderr, "%s ACL: access to",
984 be == NULL ? "Global" : "Backend" );
986 if ( a->acl_dn_pat != NULL ) {
988 fprintf( stderr, " dn=%s\n",
992 if ( a->acl_filter != NULL ) {
994 fprintf( stderr, " filter=" );
995 filter_print( a->acl_filter );
996 fprintf( stderr, "\n" );
999 if ( a->acl_attrs != NULL ) {
1003 fprintf( stderr, " attrs=" );
1004 for ( i = 0; a->acl_attrs[i] != NULL; i++ ) {
1006 fprintf( stderr, "," );
1008 fprintf( stderr, a->acl_attrs[i] );
1011 fprintf( stderr, "\n" );
1015 fprintf( stderr, " *\n" );
1018 for ( b = a->acl_access; b != NULL; b = b->a_next ) {
1022 fprintf( stderr, "\n" );
1025 #endif /* LDAP_DEBUG */