vgu 4dZddlmcmZddlmZddlZidddddd d d d d ddddddddddddddddddd d!d"d#d$d%id&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;dd?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPZgdQZ GdRdSZ y)Tz This module provides a Python interface to interact with a COSEC biometric device. It allows users to perform various operations such as configuring device settings, managing users, retrieving attendance events, etc. N) b64encode0 Successful1z"Failed - Invalid Login Credentials2zDate and time manual set failed3zInvalid Date/Time4z%Maximum users are already configured.5zImage size is too big.6zImage format not supported7zCard 1 and card 2 are identical8zCard ID exists9zdFinger print template/ Palm template/ Face template already exists/ Face Image already exists10zNo Record Found11zTemplate size/ format mismatch12zFP Memory full13zUser id not found14zCredential limit reached15z&Reader mismatch/ Reader not configured16z Device Busy17zInternal process error 18zPIN already exists19zCredential not found20zMemory Card Not Found21zReference User ID exists22zWrong Selection23zPalm template mode mismatch24z(Feature not enabled in the configuration25z2Message already exists for same user for same date26zMInvalid smart card format/Parameters not applicable as per card type defined.27zTime Out28zRead/Write failed29zWrong Card Type30z key mismatch31z invalid card32z Scan failed33z Invalid valuezCredential does not matchFailurezFace Not Detectedz User ConflictzEnroll ConflictzFace Mask DetectedzFull Face Not VisiblezFace Not Straight)3435363738394041)zenroll-on-devicez week-day0z week-day1z week-day2z week-day3z week-day4z week-day5z week-day6alarmz tamper-alarmzauto-alarm-ackzthresh-temp-exceededzallow-exit-when-lockedz auto-relockz asc-activezdoor-sense-activez exit-switchzaux-output-enablezgreeting-msg-enablez buzzer-muteenablezenable-signal-waitzread-csnceZdZdZddZdZdZdZdZddZ ddZ dd Z dd Z dd Z dd Zdd ZddZddZddZd dZdZdZ d!dZdZd"dZd#dZdZdZdZd$dZy)%COSECBiometrica A Python interface to interact with a COSEC biometric device. This class provides methods for configuring device settings, managing users, retrieving attendance events, and other operations. Usage: 1. Instantiate the COSECBiometric class with the required parameters: IP address, port, username, and password. 2. Use the provided methods to perform specific actions on the biometric device. c||_||_||_||_||_d|j i|_d|jd|_g|_y)a Initialize the COSECBiometric object with the specified parameters. Args: machine_ip (str): The IP address of the COSEC biometric device. port (int): The port number of the COSEC biometric device. username (str): The username for accessing the biometric device. password (str): The password for accessing the biometric device. timeout (int, optional): The timeout for HTTP requests (default is 60 seconds). Authorizationzhttp://z /device.cgiN) _COSECBiometric__ip_COSECBiometric__port_COSECBiometric__timeout_COSECBiometric__username_COSECBiometric__password%_COSECBiometric__generate_auth_header_COSECBiometric__header_COSECBiometric__base_url_COSECBiometric__user_fields)self machine_ipportusernamepasswordtimeouts #/var/www/horilla/biometric/cosec.py__init__zCOSECBiometric.__init__bsX   ""($*E*E*GH #DII;k:c|jd|jj}dt|j zS)a Generate the Authorization header for making authenticated requests to the COSEC biometric device. This method creates an Authorization header using the provided username and password, encoded in Base64 format as per the Basic authentication scheme. Returns: str: The Authorization header value in the format 'Basic '. :zBasic )r9r:encoderdecode)r? credentialss rE__generate_auth_headerz%COSECBiometric.__generate_auth_headervs@)4??*;<CCE )K077999rGc tj|dz|j|j}|j |S#tj $rddicYSwxYw)a This method sends an HTTP GET request to the specified URL with the appropriate headers, and then parses the response to handle different scenarios such as timeouts, access errors, unsupported content types, and valid responses. &format=xmlheadersrDTimeoutzRequest Timeout)requestsgetr<r8_COSECBiometric__parse_responserR)r?urlresponses rE__send_requestzCOSECBiometric.__send_requests]  2||m#T]]DNNH((2 2 201 1 2s?AAAc|jdk7rddiS|jjddk7rddiS|jj d}t j |}|jj}|s|jd}|rbg}|jdD]J}i}|D]} | j|| j<|jd d k(s:|j|L|S|D cic]} | j| j}} |jd rtj|d } | |d <|Si}||d <|Scc} w)a Parse the response received from the COSEC biometric device. This method parses the HTTP response received from the COSEC biometric device, handles different scenarios such as HTTP status codes, content types, and response formats, and extracts relevant data from the response. Args: response (requests.Response): The HTTP response object received from the device. Returns: dict: A dictionary representing the parsed response. If the response status code is 200 (OK), and the content type is XML, the dictionary may contain response data. If there is an error or unsupported content, the dictionary will contain an appropriate error message. Errorz Access Errorz Content-Typeztext/xmlzUnsupported contentutf-8Eventszevent-id101 Response-Codemessageerror) status_coderQrTcontentrKET fromstringtextstripfindalltagappendcosec_api_response_codes) r?rW response_dataroot text_contenteventsparsed_responseevent event_dictelemr`s rE__parse_responsezCOSECBiometric.__parse_responseso$   3 &^, ,      /: =23 3 ((//8 }}]+yy( \\(+F"$!\\(3;E!#J %9/3yy 488,9!~~j1U:'..z: ; DH"H4488TYY#6"H"H"&&76::'8G29OI.!O'3OG $#Is;Ec~|dk(r|jd|d}n*|dk(r|jd|d}n|jd|d}|j|}|j}|jDcgc] }||vs| }}|r1dj|}t d|d dj|y cc}w) a` Authenticate and validate the arguments before sending a request to the COSEC biometric device. This method verifies that the provided arguments are supported by the specified URL endpoint and raises a ValueError if any unsupported arguments are found. Args: url (str): The URL endpoint for the request. kwargs (dict): A dictionary containing the arguments to be authenticated. Raises: ValueError: If any of the provided arguments are not supported by the specified URL endpoint. special-function/z?action=get&sp-fn-index=1smart-card-formatz?action=get&card-type=1&index=1z ?action=getz, zAThe following argument(s) are not supported : z. Supported arguments are: N)r=_COSECBiometric__send_requestkeysjoin ValueError)r?rVkwargsrWsupported_argsargunsupported_argsunsupported_args_strs rE__authenticate_argumentsz'COSECBiometric.__authenticate_argumentss" $ $__%Qse+DEC ' '__%Qse+JKC__%Qse;7C&&s+!+1;;=VCC~ +,,G R`HaGbd  Ws 6 B:B:c |jd|}|dk(rO|jd||ddj|jDcgc] \}}|d|c}}zz }|j |Scc}}w)a Configure or retrieve basic settings of the COSEC biometric device. This method allows the user to configure or retrieve basic settings of the COSEC biometric device, such as device name, IP settings, time settings, etc. z/device-basic-config?action=setzdevice-basic-config&=r='_COSECBiometric__authenticate_argumentsr{itemsryr?actionr}rVkeyvalues rE basic_configzCOSECBiometric.basic_configs!!=fXF U?  ) )*? H 3flln"U UcU!E7#3"UVV VC""3''#V A7c |jd|}|dk(rO|jd||ddj|jDcgc] \}}|d|c}}zz }|j |Scc}}w)a? Configure or retrieve parameters related to the finger reader of the COSEC biometric device. This method allows the user to configure or retrieve parameters related to the finger reader of the COSEC biometric device, such as sensitivity, timeout, template format, etc. z/finger-parameter?action=rzfinger-parameterrrrrs rE%finger_reader_parameter_configurationz4COSECBiometric.finger_reader_parameter_configurations!!:6(C U?  ) )* 3'-lln"Ue132F+FSZERS C ""3'' rc |jd|}|dk(rb|jd||ddj|jDcgc]\}}|d|tvr t |n|!c}}zz }|j |Scc}}w)aM Configure or retrieve door features settings of the COSEC biometric device. This method allows the user to configure or retrieve door features settings of the COSEC biometric device, such as enabling or disabling door senses, setting door open durations, configuring auxiliary outputs, etc. z/door-feature?action=rz door-featurerrrrs rEdoor_features_configurationz*COSECBiometric.door_features_configurationV!!6vh? U?  ) ).& A 3'-lln"Ue132F+FSZERS C ""3'' rc |jd|}|dk(rb|jd||ddj|jDcgc]\}}|d|tvr t |n|!c}}zz }|j |Scc}}w)a5 Configure or retrieve system timer settings of the COSEC biometric device. This method allows the user to configure or retrieve system timer settings of the COSEC biometric device, such as setting the system idle timeout, configuring system heartbeat intervals, etc. z/system-timer?action=rz system-timerrrrrs rEsystem_timer_configurationz)COSECBiometric.system_timer_configurationirrc &|jd|d|}|dk(rb|jd||ddj|jDcgc]\}}|d|tvr t |n|!c}}zz }|j |Scc}}w)z Configure special functions on the COSEC biometric device. This method allows configuring special functions on the COSEC biometric device, such as enabling or disabling specific functionalities z/special-function?action=z &sp-fn-index=rrvrrr)r?r sp_fn_indexr}rVrrs rEspecial_function_configurationz-COSECBiometric.special_function_configuration|s!!:6(-P[}] U?  ) )*r=rSr<r8rbrcrKrdrefindrfdelete_cosec_usersplitr|) r?r url_argumentsuser ref_user_idcoderVrWrlrmfieldsrs rEcheck_user_url_argumentsz'COSECBiometric.check_user_url_argumentss""7+xx(!%diik!2D KD#+''A'#K= = $<<''3.$,$4$4$;$;G$DM==7D99_5::Ds{#227;-1$))+->*..w71$K%#+&  4Cyy~a (:(::#))C.+e33 4 (OP  rGNc|r|s tdg}|jd}|jd||jd||r)t|dkDr|ddn|}|jd||,|dvr td |jd t ||,|dvr td |jd t ||,|dvr td |jdt || r@| r>| r<|jd| |jd| |jd| |r*|r(|jd||jd|| r|jd| ||jd||,|dvr td|jdt || r|jd| |r|jd||,|dvr td|jdt ||r@|r>|r<|jd||jd||jd||r|jd||,|dvr td |jd!t ||,|dvr td"|jd#t ||j |||d$d$j |zz }|j|S)%a  Set or update user information on the COSEC biometric device. This method allows setting or updating user information on the COSEC biometric device, including user details, access rights, credentials, validity periods, etc. z>Both user_id and ref_id are mandatory for create & edit a userz/users?action=setzuser-id=z ref-user-id=Nzname=)TFz/user_active must be either True, False, or Nonez user-active=z'vip must be either True, False, or Nonezvip=z3validity_enable must be either True, False, or Nonezvalidity-enable=zvalidity-date-dd=zvalidity-date-mm=zvalidity-date-yyyy=zvalidity-time-hh=zvalidity-time-mm=z user-pin=zby-pass-finger=z0by_pass_palm must be either True, False, or Nonez by-pass-palm=zcard1=zcard2=z.dob_enable must be either True, False, or Nonez dob-enable=zdob-dd=zdob-mm=z dob-yyyy=z user-group=z:self_enrollment_enable must be either True, False, or Nonezself-enrollment-enable=z-enable_fr must be either True, False, or Nonez enable-fr=r)r|r=rjlenrrr{ry)r?rrname user_activevipvalidity_enablevalidity_time_hhvalidity_time_mmvalidity_date_ddvalidity_date_mmvalidity_date_yyyyuser_pincard1card2by_pass_finger dob_enabledob_dddob_mmdob_yyyy by_pass_palm user_groupself_enrollment_enable enable_frrrVtruncated_names rEset_cosec_userzCOSECBiometric.set_cosec_usersBkP  !!23xy12|K=9: *-d)b.T#2YdN  5(8!9 :  "-/ !RSS  <K0@/A!B C ?-' !JKK  4Cz!2 3  &m3 !VWW  #3C4H3I!J K  05G  #45E4F!G H  #45E4F!G H  #67I6J!K L  0  #45E4F!G H  #45E4F!G H   9XJ!7 8  %  ?>2B!C D  #=0 !STT  =\1B0C!D E   6%!1 2   6%!1 2  !. !QRR  ;s:.?!@ A f  76(!3 4  76(!3 4  9XJ!7 8   ;zl!; < ! -%]: P  )#.D*E)FG    - !PQQ  :c)n-=!> ? %%g}= sSXXm,,,""3''rGcF|jd|}|j|S)z Delete a user from the COSEC biometric device. This method deletes a user with the specified user ID from the COSEC biometric device. z/users?action=delete&user-id=rrs rErz COSECBiometric.delete_cosec_users+!!>wiH""3''rGc`|jd|dt|d}|j|S)zZ Enable or disable face recognition for a user in cosec biometric device. rz &enable-fr=rO)r=rry)r?rrrVs rEenable_user_face_recognitionz+COSECBiometric.enable_user_face_recognitions@ 9'#i.) 6 ""3''rGct|trt|ts td|dks|dkDr td|dks|dkDr td|jd|d|d |}|j |S) a@ Retrieve the credential of a user from the COSEC biometric device. This method retrieves the credential of a user, such as fingerprint, card, palm template, face template, or face image, from the COSEC biometric device based on the provided user ID and credential type. z6type and finger_index arguments value must be integersrzType must be between 1 and 6 z%Finger index must be between 1 and 10z/credential?action=get&type=z &user-id=z&finger-index=) isinstancerr|r=ry)r?rcredential_type finger_indexrVs rEget_user_credentialz"COSECBiometric.get_user_credentials/3/z,PS7TUV V Q /A"5;< < ! |b0DE E;O;Ly|n > ""3''rGcF|jd|}|j|S)aJ Retrieve the credential of a user from the COSEC biometric device. This method retrieves the count of credentials of a user, such as fingerprint, card, palm template, face template, or face image, from the COSEC biometric device based on the provided user ID and credential type. z!/command?action=getcount&user-id=rrs rEget_user_credential_countz(COSECBiometric.get_user_credential_counts+!!B7)L""3''rGctdks tdkDr td|jd|d|}|j|S)aJ Delete a specific type of credential associated with a user from the COSEC biometric device. This method deletes a specific type of credential associated with a user, such as fingerprint, card, palm template, face template, or face image, from the COSEC biometric device. rrzType must be between 0 and 6z"/credential?action=delete&user-id=z&type=)typer|r=ry)r?rrrVs rEdelete_cosec_user_credentialz+COSECBiometric.delete_cosec_user_credentialsL !8tax;< <!!CG9FSbRcd""3''rGcB|jd}|j|S)z Retrieve the total number of users configured on the COSEC biometric device. This method retrieves the total number of users configured on the COSEC biometric device. z/command?action=getusercountr)r?rVs rEget_user_countzCOSECBiometric.get_user_counts' !!=>""3''rGcR|jd|d|d|}|j|S)z Retrieve attendance events from the COSEC biometric device. This method retrieves attendance events, such as punch-in and punch-out records, from the COSEC biometric device. z(/events?action=getevent&roll-over-count=z &seq-number=z&no-of-events=r)r?roll_over_countseq_num no_of_eventsrVs rEget_attendance_eventsz$COSECBiometric.get_attendance_eventssAGGX7)>, A ""3''rG)<)rT)rTr)rTrr)NNNNNNNNNNNNNNNNNNNNN)T)rr)rrd)__name__ __module__ __qualname____doc__rFr;ryrUrrrrrrrrrrrrrrrrrrrrrrrGrEr3r3Us  ( : 2.` D( ("(*(*(((&(&(&(&(&(. (+b #1O(b(((4 (($( (rGr3) rxml.etree.ElementTreeetree ElementTreerdbase64rrSrkrr3rrGrErs #",, -, *,  ,  0 ,  ! , %, *, , 3, , *, , ,  $!," 2#,$ -%,& #',( ),* +,, !-,. $/,0 1,2 '3,4 45,6 >7,8 Y9,: *;,< =,> ?,@ .A,B .C,D -E,F /G,H &      ! W,\6M (M (rG