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 a->acl_dn_pat = ch_strdup( ".*" );
126 split( argv[i], '=', &left, &right );
127 if ( right == NULL || *right == '\0' ) {
129 "%s: line %d: missing \"=\" in (or value after) \"%s\" in to clause\n",
130 fname, lineno, left );
134 if ( strcasecmp( left, "filter" ) == 0 ) {
135 if ( (a->acl_filter = str2filter(
138 "%s: line %d: bad filter \"%s\" in to clause\n",
139 fname, lineno, right );
143 } else if ( strcasecmp( left, "dn" ) == 0 ) {
144 a->acl_dn_pat = ch_strdup( right );
146 } else if ( strncasecmp( left, "attr", 4 ) == 0 ) {
149 alist = str2charray( right, "," );
150 charray_merge( &a->acl_attrs, alist );
151 charray_free( alist );
155 "%s: line %d: expecting <what> got \"%s\"\n",
156 fname, lineno, left );
161 if ( a->acl_dn_pat != NULL ) {
162 int e = regcomp( &a->acl_dn_re, a->acl_dn_pat,
163 REG_EXTENDED | REG_ICASE );
166 regerror( e, &a->acl_dn_re, buf, sizeof(buf) );
168 "%s: line %d: regular expression \"%s\" bad because of %s\n",
169 fname, lineno, right, buf );
174 /* by clause - select who has what access to entries */
175 } else if ( strcasecmp( argv[i], "by" ) == 0 ) {
178 "%s: line %d: to clause required before by clause in access line\n",
184 * by clause consists of <who> and <access>
187 b = (Access *) ch_calloc( 1, sizeof(Access) );
189 ACL_INVALIDATE( b->a_mask );
193 "%s: line %d: premature eol: expecting <who>\n",
199 for ( ; i < argc; i++ ) {
201 split( argv[i], '=', &left, &right );
203 if ( strcasecmp( argv[i], "*" ) == 0 ) {
204 pat = ch_strdup( ".*" );
205 } else if ( strcasecmp( argv[i], "anonymous" ) == 0 ) {
206 pat = ch_strdup( "anonymous" );
207 } else if ( strcasecmp( argv[i], "self" ) == 0 ) {
208 pat = ch_strdup( "self" );
209 } else if ( strcasecmp( left, "dn" ) == 0 ) {
210 regtest(fname, lineno, right);
211 pat = ch_strdup( right );
217 if( b->a_dn_pat != NULL ) {
219 "%s: line %d: dn pattern already specified.\n",
228 if ( strcasecmp( left, "dnattr" ) == 0 ) {
229 if( b->a_dn_pat != NULL ) {
231 "%s: line %d: dnaddr already specified.\n",
236 b->a_dn_at = ch_strdup( right );
240 if ( strncasecmp( left, "group", sizeof("group")-1 ) == 0 ) {
244 if( b->a_group_pat != NULL ) {
246 "%s: line %d: group pattern already specified.\n",
251 /* format of string is "group/objectClassValue/groupAttrName" */
252 if ((value = strchr(left, '/')) != NULL) {
255 && (name = strchr(value, '/')) != NULL)
261 regtest(fname, lineno, right);
262 b->a_group_pat = ch_strdup( right );
264 if (value && *value) {
265 b->a_group_oc = ch_strdup(value);
268 b->a_group_oc = ch_strdup("groupOfNames");
271 b->a_group_at = ch_strdup(name);
275 b->a_group_at = ch_strdup("member");
281 if ( strcasecmp( left, "peername" ) == 0 ) {
282 if( b->a_peername_pat != NULL ) {
284 "%s: line %d: peername pattern already specified.\n",
289 regtest(fname, lineno, right);
290 b->a_peername_pat = ch_strdup( right );
294 if ( strcasecmp( left, "sockname" ) == 0 ) {
295 if( b->a_sockname_pat != NULL ) {
297 "%s: line %d: sockname pattern already specified.\n",
302 regtest(fname, lineno, right);
303 b->a_sockname_pat = ch_strdup( right );
307 if ( strcasecmp( left, "domain" ) == 0 ) {
308 if( b->a_domain_pat != NULL ) {
310 "%s: line %d: domain pattern already specified.\n",
315 regtest(fname, lineno, right);
316 b->a_domain_pat = ch_strdup( right );
320 if ( strcasecmp( left, "sockurl" ) == 0 ) {
321 if( b->a_sockurl_pat != NULL ) {
323 "%s: line %d: sockurl pattern already specified.\n",
328 regtest(fname, lineno, right);
329 b->a_sockurl_pat = ch_strdup( right );
333 #ifdef SLAPD_ACI_ENABLED
334 if ( strcasecmp( left, "aci" ) == 0 ) {
335 if( b->a_aci_at != NULL ) {
337 "%s: line %d: aci attribute already specified.\n",
342 if ( right != NULL && *right != '\0' )
343 b->a_aci_at = ch_strdup( right );
345 b->a_aci_at = ch_strdup( SLAPD_ACI_DEFAULT_ATTR );
350 if( right != NULL ) {
357 if( i == argc || ( strcasecmp( left, "stop" ) == 0 )) {
358 /* out of arguments or plain stop */
360 ACL_PRIV_ASSIGN(b->a_mask, ACL_NONE);
361 b->a_type = ACL_STOP;
363 access_append( &a->acl_access, b );
367 if( strcasecmp( left, "continue" ) == 0 ) {
370 ACL_PRIV_ASSIGN(b->a_mask, ACL_NONE);
371 b->a_type = ACL_CONTINUE;
373 access_append( &a->acl_access, b );
377 if( strcasecmp( left, "break" ) == 0 ) {
380 ACL_PRIV_ASSIGN(b->a_mask, ACL_NONE);
381 b->a_type = ACL_BREAK;
383 access_append( &a->acl_access, b );
387 if ( strcasecmp( left, "by" ) == 0 ) {
388 /* we've gone too far */
390 ACL_PRIV_ASSIGN(b->a_mask, ACL_NONE);
391 b->a_type = ACL_STOP;
393 access_append( &a->acl_access, b );
398 if( strncasecmp( left, "self", 4 ) == 0 ) {
400 ACL_PRIV_ASSIGN( b->a_mask, str2accessmask( &left[4] ) );
403 ACL_PRIV_ASSIGN( b->a_mask, str2accessmask( left ) );
406 if( ACL_IS_INVALID( b->a_mask ) ) {
408 "%s: line %d: expecting <access> got \"%s\"\n",
409 fname, lineno, left );
413 b->a_type = ACL_STOP;
416 /* out of arguments or plain stop */
417 access_append( &a->acl_access, b );
421 if( strcasecmp( argv[i], "continue" ) == 0 ) {
423 b->a_type = ACL_CONTINUE;
425 } else if( strcasecmp( argv[i], "break" ) == 0 ) {
427 b->a_type = ACL_BREAK;
429 } else if ( strcasecmp( argv[i], "stop" ) != 0 ) {
434 access_append( &a->acl_access, b );
438 "%s: line %d: expecting \"to\" or \"by\" got \"%s\"\n",
439 fname, lineno, argv[i] );
444 /* if we have no real access clause, complain and do nothing */
447 "%s: line %d: warning: no access clause(s) specified in access line\n",
453 if (ldap_debug & LDAP_DEBUG_ACL)
457 if ( a->acl_access == NULL ) {
459 "%s: line %d: warning: no by clause(s) specified in access line\n",
464 acl_append( &be->be_acl, a );
466 acl_append( &global_acl, a );
472 accessmask2str( slap_access_mask_t mask )
474 static char buf[sizeof("unknown (+wrsca0)")];
477 if ( ACL_IS_INVALID( mask ) ) {
483 if ( ACL_IS_LEVEL( mask ) ) {
484 if ( ACL_LVL_IS_NONE(mask) ) {
485 strcat( buf, "none" );
487 } else if ( ACL_LVL_IS_AUTH(mask) ) {
488 strcat( buf, "auth" );
490 } else if ( ACL_LVL_IS_COMPARE(mask) ) {
491 strcat( buf, "compare" );
493 } else if ( ACL_LVL_IS_SEARCH(mask) ) {
494 strcat( buf, "search" );
496 } else if ( ACL_LVL_IS_READ(mask) ) {
497 strcat( buf, "read" );
499 } else if ( ACL_LVL_IS_WRITE(mask) ) {
500 strcat( buf, "write" );
502 strcat( buf, "unknown" );
508 if( ACL_IS_ADDITIVE( mask ) ) {
511 } else if( ACL_IS_SUBTRACTIVE( mask ) ) {
518 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_WRITE) ) {
523 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_READ) ) {
528 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_SEARCH) ) {
533 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_COMPARE) ) {
538 if ( ACL_PRIV_ISSET(mask, ACL_PRIV_AUTH) ) {
543 if ( none && ACL_PRIV_ISSET(mask, ACL_PRIV_NONE) ) {
547 if ( ACL_IS_LEVEL( mask ) ) {
554 str2accessmask( const char *str )
556 slap_access_mask_t mask;
558 if( !isalpha(str[0]) ) {
561 if ( str[0] == '=' ) {
564 } else if( str[0] == '+' ) {
565 ACL_PRIV_ASSIGN(mask, ACL_PRIV_ADDITIVE);
567 } else if( str[0] == '-' ) {
568 ACL_PRIV_ASSIGN(mask, ACL_PRIV_SUBSTRACTIVE);
571 ACL_INVALIDATE(mask);
575 for( i=1; str[i] != '\0'; i++ ) {
576 if( TOLOWER(str[i]) == 'w' ) {
577 ACL_PRIV_SET(mask, ACL_PRIV_WRITE);
579 } else if( TOLOWER(str[i]) == 'r' ) {
580 ACL_PRIV_SET(mask, ACL_PRIV_READ);
582 } else if( TOLOWER(str[i]) == 's' ) {
583 ACL_PRIV_SET(mask, ACL_PRIV_SEARCH);
585 } else if( TOLOWER(str[i]) == 'c' ) {
586 ACL_PRIV_SET(mask, ACL_PRIV_COMPARE);
588 } else if( TOLOWER(str[i]) == 'x' ) {
589 ACL_PRIV_SET(mask, ACL_PRIV_AUTH);
592 ACL_INVALIDATE(mask);
600 if ( strcasecmp( str, "none" ) == 0 ) {
601 ACL_LVL_ASSIGN_NONE(mask);
603 } else if ( strcasecmp( str, "auth" ) == 0 ) {
604 ACL_LVL_ASSIGN_AUTH(mask);
606 } else if ( strcasecmp( str, "compare" ) == 0 ) {
607 ACL_LVL_ASSIGN_COMPARE(mask);
609 } else if ( strcasecmp( str, "search" ) == 0 ) {
610 ACL_LVL_ASSIGN_SEARCH(mask);
612 } else if ( strcasecmp( str, "read" ) == 0 ) {
613 ACL_LVL_ASSIGN_READ(mask);
615 } else if ( strcasecmp( str, "write" ) == 0 ) {
616 ACL_LVL_ASSIGN_WRITE(mask);
619 ACL_INVALIDATE( mask );
628 fprintf( stderr, "\n"
629 "<access clause> ::= access to <what> "
630 "[ by <who> <access> <control> ]+ \n"
631 "<what> ::= * | [dn=<regex>] [filter=<ldapfilter>] [attrs=<attrlist>]\n"
632 "<attrlist> ::= <attr> | <attr> , <attrlist>\n"
633 "<attr> ::= <attrname> | entry | children\n"
634 "<who> ::= [ * | anonymous | self | dn=<regex> ]\n"
635 "\t[dnattr=<attrname>]\n"
636 "\t[group[/<objectclass>[/<attrname>]]=<regex>]\n"
637 "\t[peername=<regex>] [sockname=<regex>]\n"
638 "\t[domain=<regex>] [sockurl=<regex>]\n"
639 #ifdef SLAPD_ACI_ENABLED
640 "\t[aci=<attrname>]\n"
642 "<access> ::= [self]{<level>|<priv>}\n"
643 "<level> ::= none | auth | compare | search | read | write\n"
644 "<priv> ::= {=|+|-}{w|r|s|c|x}+\n"
645 "<control> ::= [ stop | continue | break ]\n"
647 exit( EXIT_FAILURE );
659 if ( (*right = strchr( line, splitchar )) != NULL ) {
660 *((*right)++) = '\0';
665 access_append( Access **l, Access *a )
667 for ( ; *l != NULL; l = &(*l)->a_next )
674 acl_append( AccessControl **l, AccessControl *a )
676 for ( ; *l != NULL; l = &(*l)->acl_next )
685 print_access( Access *b )
687 fprintf( stderr, "\tby" );
689 if ( b->a_dn_pat != NULL ) {
690 if( strcmp(b->a_dn_pat, "anonymous") == 0 ) {
691 fprintf( stderr, " anonymous" );
693 } else if( strcmp(b->a_dn_pat, "self") == 0 ) {
694 fprintf( stderr, " self" );
697 fprintf( stderr, " dn=%s", b->a_dn_pat );
701 if ( b->a_dn_at != NULL ) {
702 fprintf( stderr, " dnattr=%s", b->a_dn_at );
705 if ( b->a_group_pat != NULL ) {
706 fprintf( stderr, " group: %s", b->a_group_pat );
708 if ( b->a_group_oc ) {
709 fprintf( stderr, " objectClass: %s", b->a_group_oc );
711 if ( b->a_group_at ) {
712 fprintf( stderr, " attributeType: %s", b->a_group_at );
717 if ( b->a_peername_pat != NULL ) {
718 fprintf( stderr, " peername=%s", b->a_peername_pat );
721 if ( b->a_sockname_pat != NULL ) {
722 fprintf( stderr, " sockname=%s", b->a_sockname_pat );
725 if ( b->a_domain_pat != NULL ) {
726 fprintf( stderr, " domain=%s", b->a_domain_pat );
729 if ( b->a_sockurl_pat != NULL ) {
730 fprintf( stderr, " sockurl=%s", b->a_sockurl_pat );
733 #ifdef SLAPD_ACI_ENABLED
734 if ( b->a_aci_at != NULL ) {
735 fprintf( stderr, " aci=%s", b->a_aci_at );
739 fprintf( stderr, " %s%s",
740 b->a_dn_self ? "self" : "",
741 accessmask2str( b->a_mask ) );
743 fprintf( stderr, "\n" );
747 access2str( slap_access_t access )
749 if ( access == ACL_NONE ) {
752 } else if ( access == ACL_AUTH ) {
755 } else if ( access == ACL_COMPARE ) {
758 } else if ( access == ACL_SEARCH ) {
761 } else if ( access == ACL_READ ) {
764 } else if ( access == ACL_WRITE ) {
772 str2access( const char *str )
774 if ( strcasecmp( str, "none" ) == 0 ) {
777 } else if ( strcasecmp( str, "auth" ) == 0 ) {
780 } else if ( strcasecmp( str, "compare" ) == 0 ) {
783 } else if ( strcasecmp( str, "search" ) == 0 ) {
786 } else if ( strcasecmp( str, "read" ) == 0 ) {
789 } else if ( strcasecmp( str, "write" ) == 0 ) {
793 return( ACL_INVALID_ACCESS );
798 print_acl( Backend *be, AccessControl *a )
803 fprintf( stderr, "%s ACL: access to",
804 be == NULL ? "Global" : "Backend" );
806 if ( a->acl_dn_pat != NULL ) {
808 fprintf( stderr, " dn=%s\n",
812 if ( a->acl_filter != NULL ) {
814 fprintf( stderr, " filter=" );
815 filter_print( a->acl_filter );
816 fprintf( stderr, "\n" );
819 if ( a->acl_attrs != NULL ) {
823 fprintf( stderr, " attrs=" );
824 for ( i = 0; a->acl_attrs[i] != NULL; i++ ) {
826 fprintf( stderr, "," );
828 fprintf( stderr, a->acl_attrs[i] );
831 fprintf( stderr, "\n" );
835 fprintf( stderr, " *\n" );
838 for ( b = a->acl_access; b != NULL; b = b->a_next ) {
842 fprintf( stderr, "\n" );
845 #endif /* LDAP_DEBUG */