File: //lib/python3/dist-packages/samba/netcmd/__pycache__/contact.cpython-310.pyc
o
�/a�y � @ s( d dl mZ d dlZd dlZd dlZd dlmZmZ d dl m
Z
d dl m Z d dl
mZ d dlmZmZ d dlmZ d dlmZmZmZmZ d d lmZ d
d lm Z G d d
� d
e�Z G dd� de�Z G dd� de�Z G dd� de�Z G dd� de�Z!G dd� de�Z"G dd� de�Z#G dd� de�Z$dS ) � N)�
check_call�CalledProcessError)�
attrgetter)�system_session)�SamDB)� credentials�dsdb)�Net)�Command� CommandError� SuperCommand�Option)� get_bytes� )�commonc @ s e Zd ZdZdZedddeddd�ed d
ed �ed d
ed �edded �edded �edded �edded �edded �edded �edded �ed d ed �ed d ed �ed d!ed �ed"d#ed �ed$d%ed �gZd&gZe j
e j e j d'�Z
( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( (d+d)d*�Zd(S ),�cmd_adda� Add a new contact.
This command adds a new contact to the Active Directory domain.
The name of the new contact can be specified by the first argument
'contactname' or the --given-name, --initial and --surname arguments.
If no 'contactname' is given, contact's name will be made up of the given
arguments by combining the given-name, initials and surname. Each argument
is optional. A dot ('.') will be appended to the initials automatically.
Example1:
samba-tool contact add "James T. Kirk" --job-title=Captain \
-H ldap://samba.samdom.example.com -UAdministrator%Passw1rd
The example shows how to add a new contact to the domain against a remote
LDAP server.
Example2:
samba-tool contact add --given-name=James --initials=T --surname=Kirk
The example shows how to add a new contact to the domain against a local
server. The resulting name is "James T. Kirk".
z %prog [contactname] [options]�-H�--URL�%LDB URL for database or target server�URL�H��help�type�metavar�destz--ouz�DN of alternative location (with or without domainDN counterpart) in which the new contact will be created. E.g. 'OU=<OU name>'. Default is the domain base.�r r � --surnamezContact's surname� --given-namezContact's given name�
--initialszContact's initials�--display-namezContact's display namez --job-titlezContact's job titlez --departmentzContact's departmentz --companyzContact's companyz
--descriptionzContact's description�--mail-addresszContact's email addressz--internet-addresszContact's home pagez--telephone-numberzContact's phone numberz--mobile-numberz Contact's mobile phone numberz--physical-delivery-officezContact's office locationzfullcontactname?�� sambaopts�credopts� versionoptsNc C s� |� � }|�|�}z t|t� ||d�}|j||||| |
| | |
||||||d�}W n ty9 } ztd|��d }~ww | j�d| � d S )N��url� session_infor �lp)�fullcontactname�ou�surname� givenname�initials� displayname�jobtitle�
department�company� description� mailaddress�internetaddress�telephonenumber� mobilenumber�physicaldeliveryofficezFailed to add contactz Contact '%s' added successfully
) � get_loadparm�get_credentialsr r �
newcontact� Exceptionr �outf�write)�selfr* r# r$ r% r r+ r, �
given_namer. � display_name� job_titler1 r2 r3 � mail_address�internet_address�telephone_number�
mobile_number�physical_delivery_officer) �creds�samdb�ret_name�e� rL �6/usr/lib/python3/dist-packages/samba/netcmd/contact.py�runj s<
�
�
��z cmd_add.run)NNNNNNNNNNNNNNNNNNN��__name__�
__module__� __qualname__�__doc__�synopsisr
�str�
takes_options�
takes_args�options� SambaOptions�CredentialsOptions�VersionOptions�takes_optiongroupsrN rL rL rL rM r + sn �� ��� ��r c @ sT e Zd ZdZdZedddeddd�gZd gZe j
e j e j d
�Z
dd d
�Zd S )�
cmd_deletea4 Delete a contact.
This command deletes a contact object from the Active Directory domain.
The contactname specified on the command is the common name or the
distinguished name of the contact object. The distinguished name of the
contact can be specified with or without the domainDN component.
Example:
samba-tool contact delete Contact1 \
-H ldap://samba.samdom.example.com \
--username=Administrator --password=Passw1rd
The example shows how to delete a contact in the domain against a remote
LDAP server.
� %prog <contactname> [options]r r r r r r � contactnamer" Nc
C s\ |� � }|j|dd�}t|t� ||d�}|�� } tj}
dt�|� } |�� � d�rJd} tj
}
z|� |�} W n t yI } zt
d|| f ��d } ~ ww z|j| |
| dgd �}
|
d
j}W n
tyh t
d | ��w t|
�d kr�t|
td�d
�D ] }| j�d|j � qwt
d| ��z|�|� W n t y� } zt
d| | ��d } ~ ww | j�d| � d S )NT��fallback_machiner& �!(&(objectClass=contact)(name=%s))�CN=�(objectClass=contact)�Invalid dn "%s": %s�dn��base�scope�
expression�attrsr �Unable to find contact "%s"r ��key�
found: %s
�FMultiple results for contact '%s'
Please specify the contact's full DNz Failed to remove contact "%s"zDeleted contact %s
)r9 r: r r � domain_dn�ldb�
SCOPE_SUBTREE�
binary_encode�upper�
startswith�
SCOPE_BASE�normalize_dn_in_domainr< r �searchrf �
IndexError�len�sortedr r= r> �delete)r? r_ r# r$ r% r r) rH rI �base_dnri �filterrK �res�
contact_dn�msgrL rL rM rN � s\ ������ � ���zcmd_delete.run�NNNNrO rL rL rL rM r] � s* �� ��r] c @ sp e Zd ZdZdZedddeddd�ed d
d ed �ed
ddddd�gZej ej
ej d�Z ddd�Z
dS )�cmd_listzList all contacts.
z%prog [options]r r r r r r z-bz --base-dnzSpecify base DN to use.r z --full-dn�full_dnF�
store_truez.Display contact's full DN instead of the name.)r �default�actionr r" Nc C s� |� � }|j|dd�}t|t� ||d�} | �� }
|r | �|�}
| j|
tjddgd�} t | �dkr2d S |rJt
| t d�d �D ] } | j �
d
| j � q<d S | D ]} | jddd �}
| j �
d
|
� qLd S ) NTr` r& rd �name)ri rj rk r rf rm z%s
)�idx)r9 r: r r rq rx ry rr rs r{ r| r r= r> rf �get)r? r# r$ r% r r~ r� r) rH rI � search_dnr� r� � contact_namerL rL rM rN s2 �
� �z cmd_list.run)NNNNNF)rP rQ rR rS rT r
rU rV rX rY rZ r[ r\ rN rL rL rL rM r� � s@ ������r� c @ sb e Zd ZdZdZedddeddd�ed d
ed �gZd gZe j
e j e j d
�Z
ddd�ZdS )�cmd_editaH Modify a contact.
This command will allow editing of a contact object in the Active Directory
domain. You will then be able to add or change attributes and their values.
The contactname specified on the command is the common name or the
distinguished name of the contact object. The distinguished name of the
contact can be specified with 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 contact edit Contact1 -H ldap://samba.samdom.example.com \
-U Administrator --password=Passw1rd
Example1 shows how to edit a contact's attributes in the domain against a
remote LDAP server.
The -H parameter is used to specify the remote target server.
Example2:
samba-tool contact edit CN=Contact2,OU=people,DC=samdom,DC=example,DC=com
Example2 shows how to edit a contact's attributes in the domain against a
local server. The contact, which is located in the 'people' OU,
is specified by the full distinguished name.
Example3:
samba-tool contact edit Contact3 --editor=nano
Example3 shows how to edit a contact's attributes in the domain against a
local server using the 'nano' editor.
r^ r r r r r r z--editorzQEditor to use instead of the system default, or 'vi' if no system default is set.r r_ r" Nc C sz |� � }|j|dd�}t|t� ||d�} | �� }
tj} dt�|� } |�� � d�rJd} tj
} z| � |�}
W n t yI }
zt
d||
f ��d }
~
ww z| j|
| | d�}|d j}W n
tyf t
d
| ��w t|�d kr�t|td �d
�D ] }| j�d|j � qut
d| ��|D ]m}t�| |�}|d u r�tj�d�}|d u r�d}tj dd��G}|�t |�� |� � z t ||j g� W n t!y� }
zt!d|
��d }
~
ww t"|j �� }|�#� }W d � n1 s�w Y W d � n1 s�w Y q�| �$|�}t%|�d }| �&||�}t|�d k�r| j�d� d S z| �'|� W n t �y2 }
zt
d| |
��d }
~
ww | j�d| � d S )NTr` r& rb rc rd re )rh ri rj r rl r rf rm ro rp �EDITOR�viz.tmp)�suffixzERROR: zNothing to do
z Failed to modify contact '%s': z#Modified contact '%s' successfully
)(r9 r: r r rq rr rs rt ru rv rw rx r< r ry rf rz r{ r| r r= r> r �get_ldif_for_editor�os�environr� �tempfile�NamedTemporaryFiler �flushr r� r �open�read�
parse_ldif�next�msg_diff�modify)r? r_ r# r$ r% r �editorr) rH rI r~ ri r rK r� r� r� � result_ldif�t_file� edited_file�edited_message� msgs_edited�
msg_edited� res_msg_diffrL rL rM rN q s� ������ � �
��
�� ��
���z cmd_edit.run�NNNNNrO rL rL rL rM r� 6 s4 $���
��r� c @ sd e Zd ZdZdZedddeddd�ed d
ed d �gZd
gZe j
e j e j d�Z
ddd�ZdS )�cmd_showa� Display a contact.
This command displays a contact object with it's attributes in the Active
Directory domain.
The contactname specified on the command is the common name or the
distinguished name of the contact object. The distinguished name of the
contact can be specified with 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 contact show Contact1 -H ldap://samba.samdom.example.com \
-U Administrator --password=Passw1rd
Example1 shows how to display a contact's attributes in the domain against
a remote LDAP server.
The -H parameter is used to specify the remote target server.
Example2:
samba-tool contact show CN=Contact2,OU=people,DC=samdom,DC=example,DC=com
Example2 shows how to display a contact's attributes in the domain against
a local server. The contact, which is located in the 'people' OU, is
specified by the full distinguished name.
Example3:
samba-tool contact show Contact3 --attributes=mail,mobile
Example3 shows how to display a contact's mail and mobile attributes.
r^ r r r r r r z --attributesz:Comma separated list of attributes, which will be printed.�
contact_attrs)r r r r_ r" Nc
C sH |� � }|j|dd�}t|t� ||d�} | �� }
tj} d } |r$|�d�} dt�|� }
|� � �
d�rSd}
tj } z| � |�}
W n t
yR } ztd||f ��d }~ww z| j|
|
| | d �}|d
j}W n
typ td | ��w t|�d kr�t|td
�d�D ] }| j�d|j � qtd| ��|D ]}t�| |�}| j�|� q�d S )NTr` r& �,rb rc rd re )rh rj ri rk r rl r rf rm ro zAMultiple results for contact '%s'
Please specify the contact's DN)r9 r: r r rq rr rs �splitrt ru rv rw rx r< r ry rf rz r{ r| r r= r> r r� )r? r_ r# r$ r% r r� r) rH rI r~ ri rk r rK r� r� r� � contact_ldifrL rL rM rN � s\ �
����� � � �z cmd_show.runr� rO rL rL rL rM r� � s6 #�����r� c @ sV e Zd ZdZdZedddeddd�gZd d
gZe j
e j e j d �Z
dd
d�Zd S )�cmd_movea] Move a contact object to an organizational unit or container.
The contactname specified on the command is the common name or the
distinguished name of the contact object. The distinguished name of the
contact can be specified with or without the domainDN component.
The name of the organizational unit or container can be specified as the
distinguished name, with 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 contact move Contact1 'OU=people' \
-H ldap://samba.samdom.example.com -U Administrator
Example1 shows how to move a contact Contact1 into the 'people'
organizational unit on a remote LDAP server.
The -H parameter is used to specify the remote target server.
Example2:
samba-tool contact move Contact1 OU=Contacts,DC=samdom,DC=example,DC=com
Example2 shows how to move a contact Contact1 into the OU=Contacts
organizational unit on the local server.
z-%prog <contactname> <new_parent_dn> [options]r r r r r r r_ �
new_parent_dnr" Nc
C s� |� � }|j|dd�}t|t� ||d�} | �� }
tj} dt�|� } |�� � d�rJd} tj
} z| � |�}
W n t yI }
zt
d||
f ��d }
~
ww z| j|
| | dgd �}|d
j}W n
tyh t
d | ��w t|�d kr�t|td�d
�D ] }| j�d|j � qwt
d| ��z| � |�}W n t y� }
zt
d||
f ��d }
~
ww t�| t|��}|�t|�d � |�|� z| �||� W n t y� }
zt
d| |
��d }
~
ww | j�d||f � d S )NTr` r& rb rc rd re rf rg r rl r rm ro rp z Invalid new_parent_dn "%s": %szFailed to move contact "%s"z Moved contact "%s" into "%s"
)r9 r: r r rq rr rs rt ru rv rw rx r< r ry rf rz r{ r| r r= r> �DnrU �remove_base_components�add_base�rename)r? r_ r� r# r$ r% r r) rH rI r~ ri r rK r� r� r� �full_new_parent_dn�full_new_contact_dnrL rL rM rN b sv ������ � ����
��
�z cmd_move.runr� rO rL rL rL rM r� 1 s* �� � �r� c @ s� e Zd ZdZdZedddeddd�ed d
ed �ed d
ed �edded �eddedd�edddd�edded �edded �gZd gZe j
e j e j d �Z
d!d d �Zd S )"�
cmd_renamea� Rename a contact and related attributes.
This command allows to set the contact's name related attributes.
The contact's new CN will be made up by combining the given-name, initials
and surname. A dot ('.') will be appended to the initials automatically, if
required.
Use the --force-new-cn option to specify the new CN manually and the
--reset-cn option to reset this changes.
Use an empty attribute value to remove the specified attribute.
The contactname specified on the command is the CN.
The command may be run locally 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 contact rename "John Doe" --surname=Bloggs \
--force-new-cn=John
Example1 shows how to change the surname ('sn' attribute) of a contact
'John Doe' to 'Bloggs' and change the CN to 'John' on the local server.
Example2:
samba-tool contact rename "J Doe" --given-name=John
-H ldap://samba.samdom.example.com -U administrator
Example2 shows how to rename the given name of a contact 'J Doe' to
'John'. The contact's cn will be renamed automatically, based on
the given name, initials and surname, if the previous CN is the
standard combination of the previous name attributes.
The -H parameter is used to specify the remote target server.
r^ r r r r r r r z New surnamer r zNew given namer z New initialsz--force-new-cnz^Specify a new CN (RDN) instead of using a combination of the given name, initials and surname.�NEW_CN)r r r z
--reset-cnz�Set the CN (RDN) to the combination of the given name, initials and surname. Use this option to reset the changes made with the --force-new-cn option.r� )r r� r zNew display namer! zNew email addressr_ r" Nc
C s� | r| rt d��| dkrt d��|�� }
|j|
dd�}t|t� ||
d�}t�||�� �}dt�|� }z|j |tj
|g d�d �}|d
}|j }W n
t yU t d | ��w |�
� }|d d
}| d urg| }n |j||||d
�}|j|d�}t|�t|�ko�t|�t|�kp�| p�t| �}t�|d| �}|�|� |dkr�|r�t d| ��t�� }||_ |�||d|� |�||d|� |�||d|� |�||d|
� |�||d| � t|�d
k} |�� z| dkr�|�|� |r�|�||� W n t�y } z |�� t d| | ��d } ~ ww |�� |�r | j� d|||f � | �rI| j� d| � |� � D ] } | dk�r4�q+| j� d| || �rB|| ndf � �q+d S d S ) NzEIt is not allowed to specify --force-new-cn together with --reset-cn.� z:Failed to rename contact - delete protected attribute 'CN'Tr` r& rb )r� �sn� givenName�cnr. � displayName�mailrg r rl r� )� old_attrsr@ r. r, )r� zCN=%sz�Failed to rename contact '%s' - can not set an empty CN (please use --force-new-cn to specify a different CN or --given-name, --initials or --surname to set name attributes)r� r� r. r� r� z Failed to rename contact "%s"z:Renamed CN of contact "%s" from "%s" to "%s" successfully
zEFollowing attributes of contact "%s" have been changed successfully:
rf z%s: %s
z [removed]) r r9 r: r r rr r� rq rt ry rs rf rz �parent�fullname_from_namesrU �boolr� �Message�prepare_attr_replacer{ �transaction_startr� r� r< �transaction_cancel�transaction_commitr= r> �keys) r? r_ r$ r# r% r r, r@ r. � force_new_cnrA rC �reset_cnr) rH rI rq r r� � old_contactr� �contact_parent_dn�old_cn�new_cn� excepted_cn�must_change_cn�new_contact_dnr� �contact_attributes_changedrK �attrrL rL rM rN � s� ���
� � ��
�
�����
� ��zcmd_rename.run) NNNNNNNNNNNrO rL rL rL rM r� � sZ %��������� ��r� c @ sd e Zd ZdZi Ze� ed< e� ed< e� ed< e� ed< e� ed< e � ed< e
� ed< e � ed < d
S ) � cmd_contactzContact management.�add�creater} �edit�list�move�showr� N) rP rQ rR rS � subcommandsr r] r� r� r� r� r� rL rL rL rM r� R s
r� )%� samba.getopt�getoptrX rr r� r� �
subprocessr r �operatorr �
samba.authr � samba.samdbr �sambar r � samba.netr � samba.netcmdr
r r r
� samba.commonr r� r r r] r� r� r� r� r� r� rL rL rL rM �<module> s. rWB
ro 3