One Hat Cyber Team
Your IP :
3.135.198.165
Server IP :
192.145.235.60
Server :
Linux ngx365.inmotionhosting.com 5.14.0-427.33.1.el9_4.x86_64 #1 SMP PREEMPT_DYNAMIC Fri Aug 30 09:45:56 EDT 2024 x86_64
Server Software :
Apache
PHP Version :
8.2.27
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
opt
/
saltstack
/
salt
/
extras-3.10
/
rads
/
__pycache__
/
View File Name :
_users.cpython-310.pyc
o �<�f�1 � @ s d Z ddlZddlZddlZddlZddlmZmZmZ ddl Z ddl m Z ddl m Z mZmZ G dd� de�Zd efd d �Zd e_d ed efdd�Zd e_ed1ded d ee fdd��Zed2ded d eeef fdd��Zd1ded eeeef ee f fdd�Zd e_d efdd�Zd e_d ed efdd�Zd e_d ed efdd �Z d e _d ed ee fd d �Z d e _d ed efd d!�Z d e _d ed efd"d#�Z d e _d efd$d%�Z d e _d ed efd&d'�Z!d e!_d(ed efd)d*�Z"d e"_d+d,� Z#G d-d.� d.�Z$G d/d0� d0�Z%dS )3z2Functions for fetching basic info on user accounts� N)�Literal�Union�overload� )�DumbYamlLoader)� SYS_USERS� STAFF_GROUPS� OUR_RESELLERSc @ s e Zd ZdZdZdS )� CpuserErrorz?Raised when there's something wrong collecting cPanel user info�radsN)�__name__� __module__� __qualname__�__doc__� r r �./opt/saltstack/salt/extras-3.10/rads/_users.pyr s r �returnc C s4 zt �� } W | S ty t�t �� �j} Y | S w )zEObtain which user ran this script Returns: username )�os�getlogin�OSError�pwd�getpwuid�geteuid�pw_name)Zblamer r r � get_login s ��r r �userc C s` zt �| �j}W n ty Y dS w ttj�|�tj�tj� d| ��tj�tj� d| ��f�S )aB Checks if a user is a valid cPanel user. Warning: This only checks if the user exists and will also be true for restricted cPanel users. Use ``cpuser_safe`` instead if you need to check for those Args: user: cPanel username to check Returns: Whether the cPanel user exists Fz/var/cpanel/users�/var/cpanel/userdata) r �getpwnam�pw_dir�KeyError�allr �path�isdir�isfile�join)r �homedirr r r � is_cpuser# s � ��r& F�ownersc C � d S �Nr �r' r r r � all_cpusers> � r+ Tc C r( r) r r* r r r r+ C r, c C s^ t ddd��}t�|t�}W d � n1 sw Y t|t�s%td��| r)|S t|�� �S )a( Returns cPanel users from /etc/trueuserowners Args: owners: whether to return users as a dict with owners as the values Raises: CpuserError: if /etc/trueuserowners is invalid Returns: either a list of all users, or a dict of users (keys) to owners (vals) z/etc/trueuserowners�utf-8��encodingNz /etc/trueuserowners is invalid) �open�yaml�loadr � isinstance�dictr �list�keys)r' Z userownersZuserdictr r r r+ H s � c C s dd� t dd��� D �S )zxGet a all non-child, non-system, "main" cPanel users Raises: CpuserError: if /etc/trueuserowners is invalidc S s$ g | ]\}}|t v s||kr|�qS r )r )�.0r �ownerr r r � <listcomp>c � �z main_cpusers.<locals>.<listcomp>Tr* �r+ �itemsr r r r � main_cpusers^ s �r= c C s: zt dd�| W S ty } zt| � d��|�d}~ww )a� Get a user's owner (even if the account has reseller ownership of itself) Warning: the owner may be root, which is not a cPanel user Hint: If looking this up for multiple users, use ``get_cpusers(owners=True)`` instead Args: user: cPanel username to find the owner for Raises: CpuserError: if /etc/trueuserowners is invalid or the requested user is not defined in there Tr* z is not in /etc/trueuserownersN)r+ r r )r �excr r r � get_ownerm s ��r? c C s t | �}|tvo || kS )z�Check if a cPanel user is not self-owned and not owned by a system user Args: user: cPanel username to check Raises: CpuserError: if /etc/trueuserowners is invalid or the requested user is not defined in there )r? r )r r8 r r r �is_child� s r@ r8 c s � fdd�t dd��� D �S )z�Get a list of child accounts for a reseller Args: owner: cPanel username to lookup Returns: all child accounts of a reseller, excluding itself Raises: CpuserError: if /etc/trueuserowners is invalid c s$ g | ]\}}|� kr||kr|�qS r r )r7 �usrZown�r8 r r r9 � r: z get_children.<locals>.<listcomp>Tr* r; rB r rB r � get_children� s �rC c sJ � t v s � tv s t� �sdS � fdd�t�� D �D ] }|tv r" dS qdS )z�Checks whether the user is safe for support to operate on - The user exists and is a valid cPanel user - The user is not a reserved account - The user is not in a staff group Args: user: cPanel username to check Fc s g | ] }� |j v r|j�qS r )�gr_mem�gr_name�r7 �x�r r r r9 � s z cpuser_safe.<locals>.<listcomp>T)r r r& �grp�getgrallr )r �groupr rH r � cpuser_safe� s �rL c C s t j�t j�d| ��S )z�Check if a user is currently suspended Warning: This does not check for pending suspensions Args: user: cPanel username to check z/var/cpanel/suspended)r r! �existsr$ rH r r r �cpuser_suspended� s rN c C s\ zt �| �j}W n ty } zt| � d��|�d}~ww t�d|�du r,t| �d���|S )z�Get home directory path for a cPanel user Args: user: cPanel username to check Raises: CpuserError: if the user does not exist or the home directory path found does not match the expected pattern z: no such userNz/home[0-9]*/\w+z does not match expected pattern)r r r r r �re�match)r r% r> r r r � get_homedir� s ��rQ c C s~ t j�d| d�}z!t|dd��}t�|�d W d � W S 1 s"w Y W dS tjttfy> } zt |�|�d}~ww )z�Get primary domain from cpanel userdata Args: user: cPanel username to check Raises: CpuserError: if cpanel userdata cannot be read or main_domain is missing r �mainr- r. � main_domainN) r r! r$ r0 r1 � safe_loadZ YAMLErrorr r r )r Z userdata_pathZuserdata_filehandler> r r r �get_primary_domain� s (� ��rU �domainc sx z.t ddd�� }t� fdd�|D ��}|�� �d�d W d � W S 1 s'w Y W dS tttfy; Y dS w ) z� Get the cPanel username that owns a domain Args: domain: Domain name to look up Returns: The name of a cPanel user that owns the domain name, or None on failure z/etc/userdomainsr- r. c 3 s$ � | ] }|� � � d ��r|V qdS )�: N)� startswithrF �rV r r � <genexpr> s �" zwhoowns.<locals>.<genexpr>rW r N)r0 �next�rstrip�splitr �FileNotFoundError� StopIteration)rV �filerP r rY r �whoowns� s (��ra c C s t j�d| |�}z$t|dd�� }t�|�}W d � n1 s w Y t|t�s+t�W n' t y@ } zt |�d��|�d}~w tyS } zt |�d��|�d}~ww |� � D ]!\}}||vrit |�d|����t|| |�syt |�d|����qXt j� |� d ��|d < |S ) zBInternal helper function for UserData to strictly parse YAML filesr r- r. Nz could not be openedz could not be parsedz is missing z contains invalid data for Z_SSL�has_ssl) r r! r$ r0 r1 rT r3 r4 � ValueErrorr r r< r# ) r �domfile�requiredr! �handle�datar> �keyZreq_typer r r �_read_userdata_yaml s. � �����ri c @ s� e Zd ZU dZeed< ded< ed ed< ed ed< ed ed< dZdefd d �Zd d � Ze d d� �Z e dee fdd��Z e dee fdd��Z dS )�UserDataa# Object representing the data parsed from userdata Args: user: cPanel username to read cPanel userdata for Raises: CpuserError: if cPanel userdata is invalid Attributes: user (str): username primary (UserDomain): UserDomain object for the main domain addons (list): UserDomain objects for addon domains parked (list): UserDomain objects for parked domains subs (list): UserDomain objects for subdomains Hint: Use vars() to view this ``UserData`` object as a dict r � UserDomain�primary�addons�parked�subsr c C s || _ t|dttttd�d�}t||d dtid�}t|d |d |d d�| _g | _|d �� D ] \}}t||dtid�}| j� t||d |d d�� q1g | _ |d D ]}| j � t|d | jj d�� qUg | _ |d D ]}t||dtid�} | j � t|| d | d d�� qld S ) z5Initializes a UserData object given a cPanel usernamerR )rS � addon_domains�parked_domains� sub_domains)r rd re rS Z documentrootrb �rV rb �docrootrp rq Frr N) r ri �strr4 r5 rk rl rm r< �appendrn rt ro ) �selfr Z main_dataZdom_dataZaddonZ addon_fileZ addon_datarn �subZsub_datar r r �__init__: sh �� �� ��� �� ����zUserData.__init__c C s d| j �d�S )Nz UserData(�)rH �rw r r r �__repr__u s zUserData.__repr__c C s< | j t| j�dd� | jD �dd� | jD �dd� | jD �d�S )Nc S � g | ]}t |��qS r ��varsrF r r r r9 } � z%UserData.__dict__.<locals>.<listcomp>c S r} r r~ rF r r r r9 ~ r� c S r} r r~ rF r r r r9 r� )r rl rm rn ro )r r rl rm rn ro r{ r r r �__dict__x s �zUserData.__dict__r c C s> | j jh}|�dd� | jD �� |�dd� | jD �� t|�S )z All site document roots (list)c S � g | ]}|j �qS r �rt rF r r r r9 � � z&UserData.all_roots.<locals>.<listcomp>c S r� r r� rF r r r r9 � r� )rl rt �updatero rm r5 )rw Zall_dirsr r r � all_roots� s zUserData.all_rootsc C sd g }t | j�D ](}tj�|�\}}|r&|r&||v rntj�|�\}}|r&|s||vr/|�|� q|S )z2Merged, top-level document roots for a user (list))�sortedr� r r! r] rv )rw �mergedZ test_path�head�tailr r r � merged_roots� s � �zUserData.merged_rootsN) r r r r ru �__annotations__r5 ry r| �propertyr� r� r� r r r r rj ! s ; rj c @ s> e Zd ZdZdZdededefdd�Zdd � Zed d � �Z d S ) rk a) Object representing a cPanel domain in ``rads.UserData()`` Attributes: domain (str): domain name has_ssl (bool): True/False if the domain has ssl docroot (str): document root on the disk Hint: vars() can be run on this object to convert it into a dict r rV rb rt c C s || _ || _|| _d S r) rs )rw rV rb rt r r r ry � s zUserDomain.__init__c C s d| j �d| j�d| j�d�S )NzUserDomain(domain=z , has_ssl=z , docroot=rz rs r{ r r r r| � s ��zUserDomain.__repr__c C s i }dD ] }t | |�||< q|S )Nrs )�getattr)rw Zmyvars�attrr r r r� � s zUserDomain.__dict__N) r r r r ru �boolry r| r� r� r r r r rk � s rk )F)T)&r r rI rO r �typingr r r r1 Z_yamlr � r r r � Exceptionr ru r r r� r& r5 r+ r4 r= r? r@ rC rL rN rQ rU ra ri rj rk r r r r �<module> sR "( y