a Wa|@sddlmZddlmZmZmZmZddlZddl m Z ddl m Z ddl mZddlmZddlmZmZmZmZmZmZmZmZddlmZdd lmZmZdd lm Z ddl!Z!ddl"Z"d d l#m$Z$e%eeeed Z&e%eeedZ'GdddeZ(GdddeZ)GdddeZ*GdddeZ+GdddeZ,GdddeZ-GdddeZ.GdddeZ/Gdd d eZ0Gd!d"d"eZ1Gd#d$d$eZ2Gd%d&d&eZ3dS)'N)Command SuperCommand CommandErrorOption) ndr_unpack)security)system_session)SamDB)ATYPE_SECURITY_GLOBAL_GROUP"GTYPE_SECURITY_BUILTIN_LOCAL_GROUP!GTYPE_SECURITY_DOMAIN_LOCAL_GROUPGTYPE_SECURITY_GLOBAL_GROUPGTYPE_SECURITY_UNIVERSAL_GROUP%GTYPE_DISTRIBUTION_DOMAIN_LOCAL_GROUPGTYPE_DISTRIBUTION_GLOBAL_GROUP"GTYPE_DISTRIBUTION_UNIVERSAL_GROUP) defaultdict) check_callCalledProcessError) get_bytes)common)BuiltinDomainGlobal Universalrrrc @seZdZdZdZejejejdZ e ddde ddd e d d e d e d dgddde ddddgdde dde d e dde d e dde d e dde d e dde d g Z d gZd$d"d#Zd!S)% cmd_group_addaCreates a new AD group. This command creates a new Active Directory group. The groupname specified on the command is a unique sAMAccountName. An Active Directory group may contain user and computer accounts as well as other groups. An administrator creates a group and adds members to that group so they can be managed as a single entity. This helps to simplify security and system administration. Groups may also be used to establish email distribution lists, using --group-type=Distribution. Groups are located in domains in organizational units (OUs). The group's scope is a characteristic of the group that designates the extent to which the group is applied within the domain tree or forest. The group location (OU), type (security or distribution) and scope may all be specified on the samba-tool command when the group is created. The command may be run from the root userid or another authorized userid. The -H or --URL= option can be used to execute the command on a remote server. Example1: samba-tool group add Group1 -H ldap://samba.samdom.example.com --description='Simple group' Example1 adds a new group with the name Group1 added to the Users container on a remote LDAP server. The -U parameter is used to pass the userid and password of a user that exists on the remote server and is authorized to issue the command on that server. It defaults to the security type and global scope. Example2: sudo samba-tool group add Group2 --group-type=Distribution Example2 adds a new distribution group to the local server. The command is run under root using the sudo command. Example3: samba-tool group add Group3 --nis-domain=samdom --gid-number=12345 Example3 adds a new RFC2307 enabled group for NIS domain samdom and GID 12345 (both options are required to enable this feature). %prog [options] sambaopts versionoptscredopts-H--URL%LDB URL for database or target serverURLHhelptypemetavardestz --groupouzpAlternative location (without domainDN counterpart) to default CN=Users in which new user object will be createdr)r*z --group-scopeZchoicerz)Group scope (Domain | Global | Universal))r*choicesr)z --group-typeSecurityZ Distributionz$Group type (Security | Distribution)z --descriptionzGroup's descriptionz--mail-addresszGroup's email addressz--noteszGroups's notesz --gid-numberzGroup's Unix/RFC2307 GID numberz --nis-domainzSFU30 NIS Domain groupnameNc Cs|pddkrt|t}n t|t}| dur6| dusF| durN| durNtd|}|j|dd}z0t|t ||d}|j |||| | | | | dWn2t y}ztd||WYd}~n d}~00|j d|dS) Nr/zcBoth --gid-number and --nis-domain have to be set for a RFC2307-enabled group. Operation cancelled.TZfallback_machineZurlZ session_infoZ credentialslp)groupou grouptype descriptionZ mailaddressnotes gidnumberZ nisdomainzFailed to create group "%s"zAdded group %s )security_groupgetr distribution_grouprr get_loadparmget_credentialsr rZnewgroup Exceptionoutfwrite)selfr0r"r r!r'r4Z group_scopeZ group_typer6Z mail_addressr7Z gid_numberZ nis_domainZgtyper3credssamdberE4/usr/lib/python3/dist-packages/samba/netcmd/group.pyrunps$     $zcmd_group_add.run) NNNNNNNNNNNN)__name__ __module__ __qualname____doc__synopsisoptions SambaOptionsVersionOptionsCredentialsOptionstakes_optiongroupsrstrint takes_options takes_argsrGrErErErFr5s<        rc@sLeZdZdZdZejejejdZ e ddde ddd gZ d gZ dd d Zd S)cmd_group_deleteaDeletes an AD group. The command deletes an existing AD group from the Active Directory domain. The groupname specified on the command is the sAMAccountName. Deleting a group is a permanent operation. When a group is deleted, all permissions and rights that users in the group had inherited from the group account are deleted as well. The command may be run from the root userid or another authorized userid. The -H or --URL option can be used to execute the command on a remote server. Example1: samba-tool group delete Group1 -H ldap://samba.samdom.example.com -Uadministrator%passw0rd Example1 shows how to delete an AD group from a remote LDAP server. The -U parameter is used to pass the userid and password of a user that exists on the remote server and is authorized to issue the command on that server. Example2: sudo samba-tool group delete Group2 Example2 deletes group Group2 from the local server. The command is run under root using the sudo command. rrr#r$r%r&r'r(r0Nc Cs|}|j|dd}t|t||d}dt|} z(|j|tj| dgd} | dj } Wnt y|t d|Yn0z| | Wn2t y} zt d || WYd} ~ n d} ~ 00|jd |dS) NTr1r2)(&(sAMAccountName=%s)(objectClass=group))dn)basescope expressionattrsrUnable to find group "%s"zFailed to remove group "%s"zDeleted group %s )r<r=r rldb binary_encodesearch domain_dn SCOPE_SUBTREErX IndexErrorrdeleter>r?r@) rAr0r"r r!r'r3rBrCfilterresgroup_dnrDrErErFrGs,  $zcmd_group_delete.run)NNNNrHrIrJrKrLrMrNrOrPrQrrRrTrUrGrErErErFrVs rVc@sveZdZdZdZejejejdZ e ddde ddd e d d e d d e ddde de dde dgZ ddgZ dddZdS)cmd_group_add_membersaAdd members to an AD group. This command adds one or more members to an existing Active Directory group. The command accepts one or more group member names separated by commas. A group member may be a user or computer account or another Active Directory group. When a member is added to a group the member may inherit permissions and rights from the group. Likewise, when permission or rights of a group are changed, the changes may reflect in the members through inheritance. The member names specified on the command must be the sAMaccountName. Example1: samba-tool group addmembers supergroup Group1,Group2,User1 -H ldap://samba.samdom.example.com -Uadministrator%passw0rd Example1 shows how to add two groups, Group1 and Group2 and one user account, User1, to the existing AD group named supergroup. The command will be run on a remote server specified with the -H. The -U parameter is used to pass the userid and password of a user authorized to issue the command on the remote server. Example2: sudo samba-tool group addmembers supergroup User2 Example2 shows how to add a single user account, User2, to the supergroup AD group. It uses the sudo command to run as root when issuing the command. F%prog (]|--member-dn=) [options]rr#r$r%r&r'r( --member-dnzRDN of the new group member to be added. The --object-types option will be ignored.appendr)r*action--object-typesComma separated list of object types. The types are used to filter the search for the specified members. Valid values are: user, group, computer, serviceaccount, contact and all. Default: user,group,computeruser,group,computerr)defaultr*--member-base-dn:Base DN for group member search. Default is the domain DN.r-r0listofmembers?Nc  Cs|} |j| dd} |dur6|dur6|tdzpt|t| | d} g} |dur^| |7} |durt| |d7} | d}|dur| |}| j|| d||dWn6t y}ztd| ||fWYd}~n d}~00|j d|dS) NTr16Either listofmembers or --member-dn must be specified.r2,Zadd_members_operationZ member_typesmember_base_dnz+Failed to add members %r to group "%s" - %szAdded members to group %s r<r=Zusagerr rsplitnormalize_dn_in_domainZadd_remove_group_membersr>r?r@rAr0Z listofmembersr"r r!r'rzZ member_dnZ object_typesr3rBrCZ groupmembersZgroup_member_typesrDrErErFrGs:    zcmd_group_add_members.run)NNNNNNNrqrhrErErErFrisD  ric@sveZdZdZdZejejejdZ e ddde ddd e d d e d d e ddde de dde dgZ ddgZ dddZdS)cmd_group_remove_membersaRemove members from an AD group. This command removes one or more members from an existing Active Directory group. The command accepts one or more group member names separated by commas. A group member may be a user or computer account or another Active Directory group that is a member of the group specified on the command. When a member is removed from a group, inherited permissions and rights will no longer apply to the member. Example1: samba-tool group removemembers supergroup Group1 -H ldap://samba.samdom.example.com -Uadministrator%passw0rd Example1 shows how to remove Group1 from supergroup. The command will run on the remote server specified on the -H parameter. The -U parameter is used to pass the userid and password of a user authorized to issue the command on the remote server. Example2: sudo samba-tool group removemembers supergroup User1 Example2 shows how to remove a single user account, User2, from the supergroup AD group. It uses the sudo command to run as root when issuing the command. rjrr#r$r%r&r'r(rkzPDN of the group member to be removed. The --object-types option will be ignored.rlrmrorprqrrrtrur-r0rvNc  Cs|} |j| dd} |dur6|dur6|tdzpt|t| | d} g} |dur^| |7} |durt| |d7} | d}|dur| |}| j|| d||dWn6t y}ztd||f|WYd}~n d}~00|j d |dS) NTr1rwr2rxFryz+Failed to remove members %r from group "%s"zRemoved members from group %s r{r~rErErFrG\s8    (zcmd_group_remove_members.run)NNNNNNNrqrhrErErErFr)sD  rc @sreZdZdZdZedddeddded d d d d edddededddd ddgZej ej ej dZ dddZ dS)cmd_group_listzList all groups.%prog [options]r#r$r%r&r'r(z-vz --verbosez3Verbose output, showing group type and group scope. store_true)r)rnz-bz --base-dnzSpecify base DN to use.r- --full-dnfull_dnF)Display DN instead of the sAMAccountName.r,rsrnr)r r"r!NcCsV|}|j|dd} t|t| |d} dg} |r>| ddg7} | } |rT| |} | j| tjd| d} t | d krxdS|r |j d |j d | D]l}|j d |j dd d t td|dd@}|t tt dkr|j dn|t tt dkr|j dn|t tt dkrB|j dn|t tt dkrh|j dn~|t tt dkr|j dnX|t tt dkr|j dn2|t tt dkr|j dn |j dt |j dgd}|j d|qnF| D]@}|r4|j d| dq|j d|j dd d qdS) NTr1r2samaccountnamer5member(objectClass=group)rZr[r\rzQGroup Name Group Type Group Scope Members zQ-------------------------------------------------------------------------------- z%-44sidxz%slrzSecurity Builtin rzSecurity Domain rzSecurity Global rzSecurity UniversalzDistribution Global zDistribution Domain zDistribution Universalz rsz %6u %s rX)r<r=r rrar}r`r^rblenr?r@r:hexrSr9r;)rAr r"r!r'verboseZbase_dnrr3rBrCr\rarfmsgZhgtype num_membersrErErFrGsZ        zcmd_group_list.run)NNNNFNF)rHrIrJrKrLrrRrTrMrNrPrOrQrGrErErErFrs> rc@s\eZdZdZdZedddeddded d d d d dgZej ej ej dZ dgZ dddZdS)cmd_group_list_memberszList all members of an AD group. This command lists members from an existing Active Directory group. The command accepts one group name. Example1: samba-tool group listmembers "Domain Users" -H ldap://samba.samdom.example.com -Uadministrator%passw0rd rr#r$r%r&r'r(rrFrrrrr0Nc Cs|}|j|dd}z,t|t||d} dt|} z0| j| tj| dgd} | dj ddd} Wnt yt d |Yn0t t j| } | \}}d | }d ||f} | j| tj| d d gd} t| dkrWdS| D]X}|r |jd| dq|j d dd}|dur0|j d dd}|jd|qWn6tyz}zt d||fWYd}~n d}~00dS)NTr1r2z)(&(objectClass=group)(sAMAccountName=%s))Z objectSidrrrr]zz#(|(primaryGroupID=%s)(memberOf=%s))ZsamAccountNameZcnrrXz)Failed to list members of "%s" group - %s)r<r=r rr^r_r`rarbr:rcrrrZdom_sidr|rr?r@r>)rAr0r"r r!r'rr3rBrCZ search_filterrfZgroup_sid_binaryZ group_sidZ group_dom_sidZridZ group_sid_dnr member_namerDrErErFrGsR     zcmd_group_list_members.run)NNNNF)rHrIrJrKrLrrRrTrMrNrPrOrQrUrGrErErErFrs,  rc@sNeZdZdZdZedddedddgZd d gZe j e j e j d Z dd dZd S)cmd_group_moveaMove a group to an organizational unit/container. This command moves a group object into the specified organizational unit or container. The groupname specified on the command is the sAMAccountName. The name of the organizational unit or container can be specified as a full DN or without the domainDN component. The command may be run from the root userid or another authorized userid. The -H or --URL= option can be used to execute the command against a remote server. Example1: samba-tool group move Group1 'OU=OrgUnit,DC=samdom.DC=example,DC=com' \ -H ldap://samba.samdom.example.com -U administrator Example1 shows how to move a group Group1 into the 'OrgUnit' organizational unit on a remote LDAP server. The -H parameter is used to specify the remote target server. Example2: samba-tool group move Group1 CN=Users Example2 shows how to move a group Group1 back into the CN=Users container on the local server. z+%prog [options]r#r$r%r&r'r(r0 new_parent_dnrNc CsV|}|j|dd}t|t||d} t| | } dt|} z | j| | tj d} | dj } Wnt yt d|Yn0z| |}Wn6ty}zt d||jfWYd}~n d}~00t| t| }|t| d ||z| | |Wn4ty<}zt d ||WYd}~n d}~00|jd ||fdS) NTr1r2rWrYr[rZrr]zInvalid new_parent_dn "%s": %srzFailed to move group "%s"zMoved group "%s" into "%s" )r<r=r rr^ZDnrar_r`rbrXrcrr}r>messagerRZremove_base_componentsrZadd_baserenamer?r@)rAr0rr"r r!r'r3rBrCrarerfrgZfull_new_parent_dnrDZfull_new_group_dnrErErFrGYsB  $zcmd_group_move.run)NNNNrHrIrJrKrLrrRrTrUrMrNrPrOrQrGrErErErFr-src@sZeZdZdZdZedddeddded d ed d gZd gZe j e j e j dZ dddZdS)cmd_group_showaDisplay a group AD object. This command displays a group object and it's attributes in the Active Directory domain. The group name specified on the command is the sAMAccountName of the group. The command may be run from the root userid or another authorized userid. The -H or --URL= option can be used to execute the command against a remote server. Example1: samba-tool group show Group1 -H ldap://samba.samdom.example.com \ -U administrator --password=passw1rd Example1 shows how to display a group's attributes in the domain against a remote LDAP server. The -H parameter is used to specify the remote target server. Example2: samba-tool group show Group2 Example2 shows how to display a group's attributes in the domain against a local LDAP server. Example3: samba-tool group show Group3 --attributes=member,objectGUID Example3 shows how to display a groups objectGUID and member attributes. z%prog [options]r#r$r%r&r'r(z --attributesz:Comma separated list of attributes, which will be printed. group_attrs)r)r*r,r0rNcCs|}|j|dd}t|t||d} d} |r:|d} dt|} | } z"| j| | tj | d} | dj }Wnt yt d|Yn0| D]}t | |}|j|qdS) NTr1r2rxz,(&(objectCategory=group)(sAMAccountName=%s)))rYr[rZr\rr])r<r=r rr|r^r_rar`rbrXrcrrget_ldif_for_editorr?r@)rAr0r"r r!r'rr3rBrCr\redomaindnrfZuser_dnrZ group_ldifrErErFrGs,   zcmd_group_show.run)NNNNNrrErErErFr}s$ rc@sNeZdZdZdZedddedddgZej ej ej d Z d d Z dd dZd S)cmd_group_statsz+Summary statistics about group memberships.rr#r$r%r&r'r(rcCs2d}|D] \}}||kr ||kr ||7}q |S)Nr)items)rAZ range_minZ range_max group_freqsZ total_countmemberscountrErErF num_in_ranges  zcmd_group_stats.num_in_rangeNcCsp|}|j|dd}t|t||d}|}|j|tjdddgd} i} d} | D]4} t| d} t | j dgd }|| | <| |7} qT| j }|j d |j d |j d ||j d | | t|}|j d|t| }t| }|t|}||}|j d|||||d}||}|ddkrh|||dd}|j d|tt}| D]\}}||d7<qdddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-|fg}|j d.|j d |D]^}|d}|d}||kr$q`||||}|dkrd/||}|j d0||fq|j d1dS)2NTr1r2rrrrrrzGroup membership statistics* z2------------------------------------------------- zTotal groups: {0} zTotal memberships: {0} z Average members per group: %.2f zMax members: {0} ({1}) rzMedian members per group: {0} )rr)r) ) ))))')(1)2;)<E)FO)PY)Zc)d)))i+)i,i)ii)ii)ii)ii )i i)ii)ii'i'z Members Number of Groups z{0}-{1}z %13s %u z7 * Note this does not include nested group memberships )r<r=r rrar`r^rbrRr:rrr?r@formatfloatlistkeysvaluesindexmaxsortrrSrr)rAr r"r!r'r3rBrCrarfZgroup_assignmentsZtotal_membershipsrnamerZ num_groupsZaverageZ group_namesZ group_membersrZ max_membersZmidpointZmedianrgroupZbandsZbandZ band_startZband_endZband_strrErErFrGsv                 zcmd_group_stats.run)NNNN)rHrIrJrKrLrrRrTrMrNrPrOrQrrGrErErErFrs rc@sXeZdZdZdZedddeddded d ed gZd gZe j e j e j d Z dddZdS)cmd_group_editaModify Group AD object. This command will allow editing of a group account in the Active Directory domain. You will then be able to add or change attributes and their values. The groupname specified on the command is the sAMAccountName. The command may be run from the root userid or another authorized userid. The -H or --URL= option can be used to execute the command against a remote server. Example1: samba-tool group edit Group1 -H ldap://samba.samdom.example.com \ -U administrator --password=passw1rd Example1 shows how to edit a groups attributes in the domain against a remote LDAP server. The -H parameter is used to specify the remote target server. Example2: samba-tool group edit Group2 Example2 shows how to edit a groups attributes in the domain against a local server. Example3: samba-tool group edit Group3 --editor=nano Example3 shows how to edit a groups attributes in the domain against a local server using the 'nano' editor. rr#r$r%r&r'r(z--editorzQEditor to use instead of the system default, or 'vi' if no system default is set.r-r0rNc Cs&|}|j|dd}t|t||d} dt|} | } z | j| | tjd} | dj } Wnt y|t d|Yn0t | dkrt d |t | f| d}t | |}|durtjd }|durd }tjd d }|t||zt||jgWn0ty8}ztd|WYd}~n d}~00t|j}|}Wdn1sd0YWdn1s0Y| |}t|d}| ||}t |dkr|jddSz| |Wn4t!y}zt d||WYd}~n d}~00|jd|dS)NTr1r2rWrrr]rz'Invalid number of results: for "%s": %dZEDITORZviz.tmp)suffixzERROR: zNothing to do zFailed to modify group '%s': z!Modified group '%s' successfully )"r<r=r rr^r_rar`rbrXrcrrrrosenvironr:tempfileZNamedTemporaryFiler@rflushrrropenreadZ parse_ldifnextZmsg_diffr?Zmodifyr>)rAr0r"r r!r'Zeditorr3rBrCrerrfrgrZ result_ldifZt_filerDZ edited_fileZedited_messageZ msgs_editedZ msg_editedZ res_msg_diffrErErFrGds^       H    $zcmd_group_edit.run)NNNNNrrErErErFr2s"!rc@sNeZdZdZdZedddedddgZd d gZe j e j e j d Z dd dZd S)cmd_group_add_unix_attrsaAdd RFC2307 attributes to a group. This command adds Unix attributes to a group account in the Active Directory domain. The groupname specified on the command is the sAMaccountName. Unix (RFC2307) attributes will be added to the group account. Add 'idmap_ldb:use rfc2307 = Yes' to smb.conf to use these attributes for UID/GID mapping. The command may be run from the root userid or another authorized userid. The -H or --URL= option can be used to execute the command against a remote server. Example1: samba-tool group addunixattrs Group1 10000 Example1 shows how to add RFC2307 attributes to a domain enabled group account. The groups Unix ID will be set to '10000', provided this ID isn't already in use. z'%prog [options]r#r$r%r&r'r(r0r8rNc CsB|}||}t|t||d} | } dt|} | j| tj | d} t | dkrht d|| dj } d| dvrt d|d|} | j| tj | d} t | dkrt d || d s|jd d | |}z| |Wn8tjy*}zt d ||WYd}~n d}~00|jd|dS)Nr2z(samaccountname={}))rZr[rzUnable to find group '{}'Z gidNumberzGroup {} is a Unix group.z$(&(objectClass=group)(gidNumber={}))zgidNumber {} already used.zidmap_ldb:use rfc2307zYou are setting a Unix/RFC2307 GID. You may want to set 'idmap_ldb:use rfc2307 = Yes' in smb.conf to use the attributes for XID/SID-mapping. z: dn: {0} changetype: modify add: gidNumber gidNumber: {1} z!Failed to modify group '{0}': {1}z!Modified Group '{}' successfully )r<r=r rrarr^r_r`rbrrrXr:r?r@Z modify_ldifZLdbError)rAr0r8r"r r!r'r3rBrCrrerfrgZ group_modrDrErErFrGsF        zcmd_group_add_unix_attrs.run)NNNNrrErErErFrsrc@seZdZdZiZeed<eed<eed<eed<e ed<e ed<e ed<e ed <e ed <eed <eed <d S) cmd_groupzGroup management.addrdZeditZ addmembersZ removemembersrZ listmembersZmoveZshowZstatsZ addunixattrsN)rHrIrJrKZ subcommandsrrVrrirrrrrrrrErErErFrs          r)4Z samba.getoptZgetoptrMZ samba.netcmdrrrrr^Z samba.ndrrZ samba.dcerpcrZ samba.authrZ samba.samdbr Z samba.dsdbr r r r rrrr collectionsr subprocessrrZ samba.compatrrrrdictr9r;rrVrirrrrrrrrrrErErErFsD     (   V>`^VPPOfl_