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 )
161 a->acl_dn_pat = ch_strdup( "*" );
164 a->acl_dn_pat = ch_strdup( right );
170 if ( right == NULL || *right == '\0' ) {
172 "%s: line %d: missing \"=\" in (or value after) \"%s\" in to clause\n",
173 fname, lineno, left );
177 if ( strcasecmp( left, "filter" ) == 0 ) {
178 if ( (a->acl_filter = str2filter(
181 "%s: line %d: bad filter \"%s\" in to clause\n",
182 fname, lineno, right );
186 } else if ( strncasecmp( left, "attr", 4 ) == 0 ) {
189 alist = str2charray( right, "," );
190 charray_merge( &a->acl_attrs, alist );
191 charray_free( alist );
195 "%s: line %d: expecting <what> got \"%s\"\n",
196 fname, lineno, left );
201 if ( a->acl_dn_pat != NULL && strcmp(a->acl_dn_pat, "*") == 0) {
202 free( a->acl_dn_pat );
203 a->acl_dn_pat = NULL;
206 if( a->acl_dn_pat != NULL ) {
207 int e = regcomp( &a->acl_dn_re, a->acl_dn_pat,
208 REG_EXTENDED | REG_ICASE );
211 regerror( e, &a->acl_dn_re, buf, sizeof(buf) );
213 "%s: line %d: regular expression \"%s\" bad because of %s\n",
214 fname, lineno, right, buf );
219 /* by clause - select who has what access to entries */
220 } else if ( strcasecmp( argv[i], "by" ) == 0 ) {
223 "%s: line %d: to clause required before by clause in access line\n",
229 * by clause consists of <who> and <access>
232 b = (Access *) ch_calloc( 1, sizeof(Access) );
234 ACL_INVALIDATE( b->a_mask );
238 "%s: line %d: premature eol: expecting <who>\n",
244 for ( ; i < argc; i++ ) {
246 split( argv[i], '=', &left, &right );
248 if ( strcasecmp( argv[i], "*" ) == 0 ) {
249 pat = ch_strdup( "*" );
251 } else if ( strcasecmp( argv[i], "anonymous" ) == 0 ) {
252 pat = ch_strdup( "anonymous" );
254 } else if ( strcasecmp( argv[i], "self" ) == 0 ) {
255 pat = ch_strdup( "self" );
257 } else if ( strcasecmp( argv[i], "users" ) == 0 ) {
258 pat = ch_strdup( "users" );
260 } else if ( strcasecmp( left, "dn" ) == 0 ) {
261 if( right == NULL ) {
263 pat = ch_strdup( "users" );
265 } else if (*right == '\0' ) {
267 pat = ch_strdup( "anonymous" );
269 } else if ( strcmp( right, "*" ) == 0 ) {
271 /* any or users? any for now */
272 pat = ch_strdup( "users" );
274 } else if ( strcmp( right, ".+" ) == 0
275 || strcmp( right, "^.+" ) == 0
276 || strcmp( right, ".+$" ) == 0
277 || strcmp( right, "^.+$" ) == 0 )
279 pat = ch_strdup( "users" );
281 } else if ( strcmp( right, ".*" ) == 0
282 || strcmp( right, "^.*" ) == 0
283 || strcmp( right, ".*$" ) == 0
284 || strcmp( right, "^.*$" ) == 0 )
286 pat = ch_strdup( "*" );
289 regtest(fname, lineno, right);
290 pat = ch_strdup( right );
298 if( b->a_dn_pat != NULL ) {
300 "%s: line %d: dn pattern already specified.\n",
309 if ( strcasecmp( left, "dnattr" ) == 0 ) {
310 if( b->a_dn_pat != NULL ) {
312 "%s: line %d: dnaddr already specified.\n",
317 b->a_dn_at = ch_strdup( right );
321 if ( strncasecmp( left, "group", sizeof("group")-1 ) == 0 ) {
325 if( b->a_group_pat != NULL ) {
327 "%s: line %d: group pattern already specified.\n",
332 /* format of string is "group/objectClassValue/groupAttrName" */
333 if ((value = strchr(left, '/')) != NULL) {
336 && (name = strchr(value, '/')) != NULL)
342 regtest(fname, lineno, right);
343 b->a_group_pat = ch_strdup( right );
345 if (value && *value) {
346 b->a_group_oc = ch_strdup(value);
349 b->a_group_oc = ch_strdup("groupOfNames");
352 b->a_group_at = ch_strdup(name);
356 b->a_group_at = ch_strdup("member");
362 if ( strcasecmp( left, "peername" ) == 0 ) {
363 if( b->a_peername_pat != NULL ) {
365 "%s: line %d: peername pattern already specified.\n",
370 regtest(fname, lineno, right);
371 b->a_peername_pat = ch_strdup( right );
375 if ( strcasecmp( left, "sockname" ) == 0 ) {
376 if( b->a_sockname_pat != NULL ) {
378 "%s: line %d: sockname pattern already specified.\n",
383 regtest(fname, lineno, right);
384 b->a_sockname_pat = ch_strdup( right );
388 if ( strcasecmp( left, "domain" ) == 0 ) {
389 if( b->a_domain_pat != NULL ) {
391 "%s: line %d: domain pattern already specified.\n",
396 regtest(fname, lineno, right);
397 b->a_domain_pat = ch_strdup( right );
401 if ( strcasecmp( left, "sockurl" ) == 0 ) {
402 if( b->a_sockurl_pat != NULL ) {
404 "%s: line %d: sockurl pattern already specified.\n",
409 regtest(fname, lineno, right);
410 b->a_sockurl_pat = ch_strdup( right );
414 #ifdef SLAPD_ACI_ENABLED
415 if ( strcasecmp( left, "aci" ) == 0 ) {
416 if( b->a_aci_at != NULL ) {
418 "%s: line %d: aci attribute already specified.\n",
423 if ( right != NULL && *right != '\0' )
424 b->a_aci_at = ch_strdup( right );
426 b->a_aci_at = ch_strdup( SLAPD_ACI_DEFAULT_ATTR );
431 if( right != NULL ) {
438 if( i == argc || ( strcasecmp( left, "stop" ) == 0 )) {
439 /* out of arguments or plain stop */
441 ACL_PRIV_ASSIGN(b->a_mask, ACL_PRIV_ADDITIVE);
442 b->a_type = ACL_STOP;
444 access_append( &a->acl_access, b );
448 if( strcasecmp( left, "continue" ) == 0 ) {
451 ACL_PRIV_ASSIGN(b->a_mask, ACL_PRIV_ADDITIVE);
452 b->a_type = ACL_CONTINUE;
454 access_append( &a->acl_access, b );
458 if( strcasecmp( left, "break" ) == 0 ) {
461 ACL_PRIV_ASSIGN(b->a_mask, ACL_PRIV_ADDITIVE);
462 b->a_type = ACL_BREAK;
464 access_append( &a->acl_access, b );
468 if ( strcasecmp( left, "by" ) == 0 ) {
469 /* we've gone too far */
471 ACL_PRIV_ASSIGN(b->a_mask, ACL_PRIV_ADDITIVE);
472 b->a_type = ACL_STOP;
474 access_append( &a->acl_access, b );
479 if( strncasecmp( left, "self", 4 ) == 0 ) {
481 ACL_PRIV_ASSIGN( b->a_mask, str2accessmask( &left[4] ) );
484 ACL_PRIV_ASSIGN( b->a_mask, str2accessmask( left ) );
487 if( ACL_IS_INVALID( b->a_mask ) ) {
489 "%s: line %d: expecting <access> got \"%s\"\n",
490 fname, lineno, left );
494 b->a_type = ACL_STOP;
497 /* out of arguments or plain stop */
498 access_append( &a->acl_access, b );
502 if( strcasecmp( argv[i], "continue" ) == 0 ) {
504 b->a_type = ACL_CONTINUE;
506 } else if( strcasecmp( argv[i], "break" ) == 0 ) {
508 b->a_type = ACL_BREAK;
510 } else if ( strcasecmp( argv[i], "stop" ) != 0 ) {
515 access_append( &a->acl_access, b );
519 "%s: line %d: expecting \"to\" or \"by\" got \"%s\"\n",
520 fname, lineno, argv[i] );
525 /* if we have no real access clause, complain and do nothing */
528 "%s: line %d: warning: no access clause(s) specified in access line\n",
533 if (ldap_debug & LDAP_DEBUG_ACL)
537 if ( a->acl_access == NULL ) {
539 "%s: line %d: warning: no by clause(s) specified in access line\n",
544 acl_append( &be->be_acl, a );
546 acl_append( &global_acl, a );
552 accessmask2str( slap_access_mask_t mask, char *buf )
556 assert( buf != NULL );
558 if ( ACL_IS_INVALID( mask ) ) {
564 if ( ACL_IS_LEVEL( mask ) ) {
565 if ( ACL_LVL_IS_NONE(mask) ) {
566 strcat( buf, "none" );
568 } else if ( ACL_LVL_IS_AUTH(mask) ) {
569 strcat( buf, "auth" );
571 } else if ( ACL_LVL_IS_COMPARE(mask) ) {
572 strcat( buf, "compare" );
574 } else if ( ACL_LVL_IS_SEARCH(mask) ) {
575 strcat( buf, "search" );
577 } else if ( ACL_LVL_IS_READ(mask) ) {
578 strcat( buf, "read" );
580 } else if ( ACL_LVL_IS_WRITE(mask) ) {
581 strcat( buf, "write" );
583 strcat( buf, "unknown" );
589 if( ACL_IS_ADDITIVE( mask ) ) {
592 } else if( ACL_IS_SUBTRACTIVE( mask ) ) {
599 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_WRITE) ) {
604 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_READ) ) {
609 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_SEARCH) ) {
614 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_COMPARE) ) {
619 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_AUTH) ) {
624 if ( none && ACL_PRIV_ISSET(mask, ACL_PRIV_NONE) ) {
633 if ( ACL_IS_LEVEL( mask ) ) {
640 str2accessmask( const char *str )
642 slap_access_mask_t mask;
644 if( !isalpha(str[0]) ) {
647 if ( str[0] == '=' ) {
650 } else if( str[0] == '+' ) {
651 ACL_PRIV_ASSIGN(mask, ACL_PRIV_ADDITIVE);
653 } else if( str[0] == '-' ) {
654 ACL_PRIV_ASSIGN(mask, ACL_PRIV_SUBSTRACTIVE);
657 ACL_INVALIDATE(mask);
661 for( i=1; str[i] != '\0'; i++ ) {
662 if( TOLOWER(str[i]) == 'w' ) {
663 ACL_PRIV_SET(mask, ACL_PRIV_WRITE);
665 } else if( TOLOWER(str[i]) == 'r' ) {
666 ACL_PRIV_SET(mask, ACL_PRIV_READ);
668 } else if( TOLOWER(str[i]) == 's' ) {
669 ACL_PRIV_SET(mask, ACL_PRIV_SEARCH);
671 } else if( TOLOWER(str[i]) == 'c' ) {
672 ACL_PRIV_SET(mask, ACL_PRIV_COMPARE);
674 } else if( TOLOWER(str[i]) == 'x' ) {
675 ACL_PRIV_SET(mask, ACL_PRIV_AUTH);
677 } else if( str[i] != '0' ) {
678 ACL_INVALIDATE(mask);
686 if ( strcasecmp( str, "none" ) == 0 ) {
687 ACL_LVL_ASSIGN_NONE(mask);
689 } else if ( strcasecmp( str, "auth" ) == 0 ) {
690 ACL_LVL_ASSIGN_AUTH(mask);
692 } else if ( strcasecmp( str, "compare" ) == 0 ) {
693 ACL_LVL_ASSIGN_COMPARE(mask);
695 } else if ( strcasecmp( str, "search" ) == 0 ) {
696 ACL_LVL_ASSIGN_SEARCH(mask);
698 } else if ( strcasecmp( str, "read" ) == 0 ) {
699 ACL_LVL_ASSIGN_READ(mask);
701 } else if ( strcasecmp( str, "write" ) == 0 ) {
702 ACL_LVL_ASSIGN_WRITE(mask);
705 ACL_INVALIDATE( mask );
714 fprintf( stderr, "\n"
715 "<access clause> ::= access to <what> "
716 "[ by <who> <access> <control> ]+ \n"
717 "<what> ::= * | [dn=<regex>] [filter=<ldapfilter>] [attrs=<attrlist>]\n"
718 "<attrlist> ::= <attr> | <attr> , <attrlist>\n"
719 "<attr> ::= <attrname> | entry | children\n"
720 "<who> ::= [ * | anonymous | users | self | dn=<regex> ]\n"
721 "\t[dnattr=<attrname>]\n"
722 "\t[group[/<objectclass>[/<attrname>]]=<regex>]\n"
723 "\t[peername=<regex>] [sockname=<regex>]\n"
724 "\t[domain=<regex>] [sockurl=<regex>]\n"
725 #ifdef SLAPD_ACI_ENABLED
726 "\t[aci=<attrname>]\n"
728 "<access> ::= [self]{<level>|<priv>}\n"
729 "<level> ::= none | auth | compare | search | read | write\n"
730 "<priv> ::= {=|+|-}{w|r|s|c|x}+\n"
731 "<control> ::= [ stop | continue | break ]\n"
733 exit( EXIT_FAILURE );
745 if ( (*right = strchr( line, splitchar )) != NULL ) {
746 *((*right)++) = '\0';
751 access_append( Access **l, Access *a )
753 for ( ; *l != NULL; l = &(*l)->a_next )
760 acl_append( AccessControl **l, AccessControl *a )
762 for ( ; *l != NULL; l = &(*l)->acl_next )
771 print_access( Access *b )
773 char maskbuf[ACCESSMASK_MAXLEN];
775 fprintf( stderr, "\tby" );
777 if ( b->a_dn_pat != NULL ) {
778 if( strcmp(b->a_dn_pat, "*") == 0
779 || strcmp(b->a_dn_pat, "users") == 0
780 || strcmp(b->a_dn_pat, "anonymous") == 0
781 || strcmp(b->a_dn_pat, "self") == 0 )
783 fprintf( stderr, " %s", b->a_dn_pat );
786 fprintf( stderr, " dn=%s", b->a_dn_pat );
790 if ( b->a_dn_at != NULL ) {
791 fprintf( stderr, " dnattr=%s", b->a_dn_at );
794 if ( b->a_group_pat != NULL ) {
795 fprintf( stderr, " group: %s", b->a_group_pat );
797 if ( b->a_group_oc ) {
798 fprintf( stderr, " objectClass: %s", b->a_group_oc );
800 if ( b->a_group_at ) {
801 fprintf( stderr, " attributeType: %s", b->a_group_at );
806 if ( b->a_peername_pat != NULL ) {
807 fprintf( stderr, " peername=%s", b->a_peername_pat );
810 if ( b->a_sockname_pat != NULL ) {
811 fprintf( stderr, " sockname=%s", b->a_sockname_pat );
814 if ( b->a_domain_pat != NULL ) {
815 fprintf( stderr, " domain=%s", b->a_domain_pat );
818 if ( b->a_sockurl_pat != NULL ) {
819 fprintf( stderr, " sockurl=%s", b->a_sockurl_pat );
822 #ifdef SLAPD_ACI_ENABLED
823 if ( b->a_aci_at != NULL ) {
824 fprintf( stderr, " aci=%s", b->a_aci_at );
828 fprintf( stderr, " %s%s",
829 b->a_dn_self ? "self" : "",
830 accessmask2str( b->a_mask, maskbuf ) );
832 if( b->a_type == ACL_BREAK ) {
833 fprintf( stderr, " break" );
835 } else if( b->a_type == ACL_CONTINUE ) {
836 fprintf( stderr, " continue" );
838 } else if( b->a_type != ACL_STOP ) {
839 fprintf( stderr, " unknown-control" );
842 fprintf( stderr, "\n" );
846 access2str( slap_access_t access )
848 if ( access == ACL_NONE ) {
851 } else if ( access == ACL_AUTH ) {
854 } else if ( access == ACL_COMPARE ) {
857 } else if ( access == ACL_SEARCH ) {
860 } else if ( access == ACL_READ ) {
863 } else if ( access == ACL_WRITE ) {
871 str2access( const char *str )
873 if ( strcasecmp( str, "none" ) == 0 ) {
876 } else if ( strcasecmp( str, "auth" ) == 0 ) {
879 } else if ( strcasecmp( str, "compare" ) == 0 ) {
882 } else if ( strcasecmp( str, "search" ) == 0 ) {
885 } else if ( strcasecmp( str, "read" ) == 0 ) {
888 } else if ( strcasecmp( str, "write" ) == 0 ) {
892 return( ACL_INVALID_ACCESS );
897 print_acl( Backend *be, AccessControl *a )
902 fprintf( stderr, "%s ACL: access to",
903 be == NULL ? "Global" : "Backend" );
905 if ( a->acl_dn_pat != NULL ) {
907 fprintf( stderr, " dn=%s\n",
911 if ( a->acl_filter != NULL ) {
913 fprintf( stderr, " filter=" );
914 filter_print( a->acl_filter );
915 fprintf( stderr, "\n" );
918 if ( a->acl_attrs != NULL ) {
922 fprintf( stderr, " attrs=" );
923 for ( i = 0; a->acl_attrs[i] != NULL; i++ ) {
925 fprintf( stderr, "," );
927 fprintf( stderr, a->acl_attrs[i] );
930 fprintf( stderr, "\n" );
934 fprintf( stderr, " *\n" );
937 for ( b = a->acl_access; b != NULL; b = b->a_next ) {
941 fprintf( stderr, "\n" );
944 #endif /* LDAP_DEBUG */