o sh2@sddlmZddlmZddlmZddlmZmZddl m Z ddl m Z m Z dd lmZdd lmZmZmZmZmZmZdd lZdd lZeeZGd d d ZGdddeZGdddZGdddeZ d S)) annotations)cbor) CtapError)Ctap2Info) PinProtocol)IntEnumunique)Event)OptionalCallableMappingAnyTupleDictNc@sjeZdZeGdddeZeGdddeZeGdddeZedd d Z dddZ dddZ dS) BioEnrollmentc@(eZdZdZdZdZdZdZdZdZ dS) zBioEnrollment.RESULTrrN) __name__ __module__ __qualname__MODALITYFINGERPRINT_KINDMAX_SAMPLES_REQUIRED TEMPLATE_IDLAST_SAMPLE_STATUSREMAINING_SAMPLESTEMPLATE_INFOSr$r$J/var/www/html/env_mimamsha/lib/python3.10/site-packages/fido2/ctap2/bio.pyRESULT-r&c@seZdZdZdZdS)zBioEnrollment.TEMPLATE_INFOrrN)rrrIDNAMEr$r$r$r% TEMPLATE_INFO7sr*c@seZdZdZdS)zBioEnrollment.MODALITYrN)rrr FINGERPRINTr$r$r$r%r<srinforreturnboolcCs*d|jvrdSd|jvrd|jvrdSdS)N bioEnrollT FIDO_2_1_PREuserVerificationMgmtPreviewF)optionsversions)r,r$r$r% is_supported@s   zBioEnrollment.is_supportedctaprmodalitycCsB||js td||_||_||jkrtd|ddS)Nz(Authenticator does not support BioEnrollzDevice does not support s)r4r, ValueErrorr5 get_modalityr6)selfr5r6r$r$r%__init__Ls   zBioEnrollment.__init__intcCs|jjddtjjS)zaGet bio modality. :return: The type of modality supported by the authenticator. T)r9)r5bio_enrollmentrr&rr:r$r$r%r9Us zBioEnrollment.get_modalityN)r,rr-r.)r5rr6r)r-r<) rrrr r r&r*r staticmethodr4r;r9r$r$r$r%r,s    rcseZdZdfdd ZZS) CaptureErrorcoder<cs||_td|dS)NzFingerprint capture error: )rAsuperr;)r:rA __class__r$r%r;`szCaptureError.__init__)rAr<)rrrr; __classcell__r$r$rCr%r@_sr@c@s6eZdZdZddddZ  ddddZdddZdS)FPEnrollmentContextajHelper object to perform fingerprint enrollment. :param bio: An instance of FPBioEnrollment. :param timeout: Optional timeout for fingerprint captures (ms). :ivar remaining: The number of (estimated) remaining samples needed. :ivar template_id: The ID of the new template (only available after the initial sample has been captured). Nbio'FPBioEnrollment'timeout Optional[int]cCs||_||_d|_d|_dSN)_biorI template_id remaining)r:rGrIr$r$r%r;os zFPEnrollmentContext.__init__eventOptional[Event] on_keepaliveOptional[Callable[[int], None]]r-Optional[bytes]cCsl|jdur|j|j||\|_}|_n|j|j|j||\}|_|tjjkr,t ||jdkr4|jSdS)aTCapture a fingerprint sample. This call will block for up to timeout milliseconds (or indefinitely, if timeout not specified) waiting for the user to scan their fingerprint to collect one sample. :return: None, if more samples are needed, or the template ID if enrollment is completed. Nr) rMrL enroll_beginrIrNenroll_capture_nextFPBioEnrollmentFEEDBACKFP_GOODr@)r:rOrQstatusr$r$r%captureus    zFPEnrollmentContext.captureNonecCs|jd|_dS)zCancels ongoing enrollment.N)rL enroll_cancelrMr>r$r$r%cancels  zFPEnrollmentContext.cancelrK)rGrHrIrJ)NN)rOrPrQrRr-rSr-r[)rrr__doc__r;rZr]r$r$r$r%rFes  rFcseZdZdZeGdddeZeGdddeZeGdddeZd4fdd Z d5ddZ d6ddZ   d7d8dd Z   d7d9d#d$Z d:d&d'Zd;dd0d1Zd?d2d3ZZS)@rVaImplementation of a draft specification of the bio enrollment API. WARNING: This specification is not final and this class is likely to change. NOTE: The get_fingerprint_sensor_info method does not require authentication, and can be used by setting pin_uv_protocol and pin_uv_token to None. :param ctap: An instance of a CTAP2 object. :param pin_uv_protocol: The PIN/UV protocol version used. :param pin_uv_token: A valid PIN/UV Auth Token for the current CTAP session. c@r) zFPBioEnrollment.CMDrrrrrrrN) rrr ENROLL_BEGINENROLL_CAPTURE_NEXT ENROLL_CANCELENUMERATE_ENROLLMENTSSET_NAMEREMOVE_ENROLLMENTGET_SENSOR_INFOr$r$r$r%CMDr'rgc@seZdZdZdZdZdS)zFPBioEnrollment.PARAMrrrN)rrrr TEMPLATE_NAME TIMEOUT_MSr$r$r$r%PARAMsrjc@sPeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZddZdS)zFPBioEnrollment.FEEDBACKrrrrrrrr cCsd|jdd|jS)N0x02Xz - )valuenamer>r$r$r%__str__sz FPBioEnrollment.FEEDBACK.__str__N)rrrrX FP_TOO_HIGH FP_TOO_LOW FP_TOO_LEFT FP_TOO_RIGHT FP_TOO_FAST FP_TOO_SLOWFP_POOR_QUALITY FP_TOO_SKEWED FP_TOO_SHORTFP_MERGE_FAILURE FP_EXISTSFP_DATABASE_FULLNO_USER_ACTIVITYNO_UP_TRANSITIONrvr$r$r$r%rWs" rWr5rpin_uv_protocolr pin_uv_tokenbytescs"t|tjj||_||_dSrK)rBr;rrr+rr)r:r5rrrCr$r%r;s zFPBioEnrollment.__init__NTcCsn|j||||d}|r.td|j|}|dur|t|7}|jj|d<|j|j||d<|j j di|S)N)r6sub_cmdsub_cmd_paramsrOrQz>BBr pin_uv_paramr$) r6structpackrencoderVERSION authenticaterr5r=)r:rparamsauthrOrQkwargsmsgr$r$r%_calls zFPBioEnrollment._callr-Mapping[int, Any]cCs|jtjjddS)ztGet fingerprint sensor info. :return: A dict containing FINGERPRINT_KIND and MAX_SAMPLES_REQUIRES. Fr)rrVrgrfr>r$r$r%get_fingerprint_sensor_infosz+FPBioEnrollment.get_fingerprint_sensor_inforIrJrOrPrQrR+Tuple[bytes, FPBioEnrollment.FEEDBACK, int]cCsttd|d|jtjj|durtjj|ind||d}td||tj j t |tj j |tj j fS)aStart fingerprint enrollment. Starts the process of enrolling a new fingerprint, and will wait for the user to scan their fingerprint once to provide an initial sample. :param timeout: Optional timeout in milliseconds. :return: A tuple containing the new template ID, the sample status, and the number of samples remaining to complete the enrollment. z)Starting fingerprint enrollment (timeout=)NrOrQSample capture result: )loggerdebugrrVrgr`rjrirr&r rWr!r")r:rIrOrQresultr$r$r%rTs   zFPBioEnrollment.enroll_beginrM$Tuple[FPBioEnrollment.FEEDBACK, int]cCsvtd|dtjj|i}|dur||tjj<|jtjj|||d}td|t |t j j |t j j fS)aContinue fingerprint enrollment. Continues enrolling a new fingerprint and will wait for the user to scan their fingerpring once to provide a new sample. Once the number of samples remaining is 0, the enrollment is completed. :param template_id: The template ID returned by a call to `enroll_begin`. :param timeout: Optional timeout in milliseconds. :return: A tuple containing the sample status, and the number of samples remaining to complete the enrollment. z$Capturing next sample with (timeout=rNrr)rrrVrjr rirrgrarWrr&r!r")r:rMrIrOrQrrr$r$r%rUs   z#FPBioEnrollment.enroll_capture_nextr[cCs td|jtjjdddS)z*Cancel any ongoing fingerprint enrollment.z"Cancelling fingerprint enrollment.FrN)rrrrVrgrbr>r$r$r%r\)s zFPBioEnrollment.enroll_cancelrFcCs t||S)zConvenience wrapper for doing fingerprint enrollment. See FPEnrollmentContext for details. :return: An initialized FPEnrollmentContext. )rF)r:rIr$r$r%enroll.s zFPBioEnrollment.enrollMapping[bytes, Optional[str]]c Cs\zdd|tjjtjjDWSty-}z|jtj j kr(iWYd}~Sd}~ww)zGet a dict of enrolled fingerprint templates which maps template ID's to their friendly names. :return: A dict of enrolled template_id -> name pairs. cSs"i|] }|tjj|tjjqSr$)rr*r(r)).0tr$r$r% =sz9FPBioEnrollment.enumerate_enrollments..N) rrVrgrcrr&r#rrAERRINVALID_OPTION)r:er$r$r%enumerate_enrollments6s z%FPBioEnrollment.enumerate_enrollmentsrustrcCsHtd|d||tjjtjj |tjj |it ddS)zSet/Change the friendly name of a previously enrolled fingerprint template. :param template_id: The ID of the template to change. :param name: A friendly name to give the template. zChanging name of template: z to zFingerprint template renamedN) rrhexrrVrgrdrr*r(r)r,)r:rMrur$r$r%set_nameHszFPBioEnrollment.set_namecCs:td||tjjtjj |it ddS)zzRemove a previously enrolled fingerprint template. :param template_id: The Id of the template to remove. zDeleting template: zFingerprint template deletedN) rrrrrVrgrerr*r(r,)r:rMr$r$r%remove_enrollmentXs  z!FPBioEnrollment.remove_enrollment)r5rrr rr)NTNN)r-r)NNN)rIrJrOrPrQrRr-r) rMrrIrJrOrPrQrRr-rr^rK)rIrJr-rF)r-r)rMrrurr-r[)rMrr-r[)rrrr_r r rgrjrWr;rrrTrUr\rrrrrEr$r$rCr%rVs0      $ "   rV)! __future__rrr5rbaserrpinr enumr r threadingr typingr rrrrrrlogging getLoggerrrr Exceptionr@rFrVr$r$r$r%s       32