Ë
|
¬`iq ã ó d dl Z d dlmZmZmZ d dlmZmZ g d¢ZddZ G d de
|
« Z G d d e
|
« Z G d
|
d e « Z G d d e « Z G d de « Z G d de « Z G d de « Z G d de « Z G d de « Z G d de « Zy)é N)Ú byte_stringÚbchrÚbord)Ú long_to_bytesÚ bytes_to_long) Ú DerObjectÚ
|
DerIntegerÚ
|
DerBooleanÚDerOctetStringÚDerNullÚ DerSequenceÚ DerObjectIdÚ DerBitStringÚDerSetOfc óD d} | |z }| xs | dk\ S # t $ r Y yw xY w)Nr F)Ú TypeError)ÚxÚonly_non_negativeÚtests õc H:\项ç®\archive\æµè¯ç»\èæ¬\Change_password\venv_build\Lib\site-packages\Crypto/Util/asn1.pyÚ
|
_is_numberr ( s= Ø DðØ4xð !Ð Ò * A¨¡FÐ*øô ò Ùðús c ó4 e Zd ZdZd Zd Zd Zd Zd Zd Z y) Ú BytesIO_EOFzeThis class differs from BytesIO in that a ValueError exception is
|
raised whenever EOF is reached.c ó. || _ d| _ d | _ y ©Nr )Ú_bufferÚ_indexÚ _bookmark)ÚselfÚ initial_bytess r Ú__init__zBytesIO_EOF.__init__5 s Ø$ Ø Ø ó c ó& | j | _ y ©N)r r ©r s r Ú set_bookmarkzBytesIO_EOF.set_bookmark: s Ø r" c ód | j J | j | j | j S r$ )r r r r% s r Údata_since_bookmarkz BytesIO_EOF.data_since_bookmark= s+ Ø~~Ð)Ð)Ð)Ø||DNN¨4¯;©;Ð7Ð7r" c óF t | j « | j z
|
S r$ )Úlenr r r% s r Úremaining_datazBytesIO_EOF.remaining_dataA s Ü4<<Ó 4§;¡;Ñ.Ð.r" c óÚ | j |z }|t | j « kD r#t d|t | j « fz « | j | j | }|| _ |S )Nz@Not enough data for DER decoding: expected %d bytes and found %d)r r* r Ú
|
ValueError)r ÚlengthÚ new_indexÚresults r ÚreadzBytesIO_EOF.readD sr ØKK &Ñ( Ø s4<<Ó(Ò (Ü Ð _ÐclÔnqÐrv×r~Ñr~Ónð cAñ Aó Bð Bà dkk¨)Ð4Ø Ø r" c ó< t | j d« d « S )Né r )r r1 r% s r Ú read_bytezBytesIO_EOF.read_byteM s ÜDIIaL OÓ$Ð$r" N)
|
Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r! r& r( r+ r1 r4 © r" r r r 1 s% ñ'ò ò
|
%ò8ò/òó%r" r c óL e Zd ZdZ d
|
dZd Zed « Zd Zd Z d dZ
|
d Z y) r zpBase class for defining a single DER object.
|
|
This class should never be directly instantiated.
|
Nc ó |d| _ y| j |« }|| _ |rdnd}d||fvr t d« | d|z | j |« z | _ y|$d| j |« z | _ ||z | _ y||z | _ y)aù Initialize the DER object according to a specific ASN.1 type.
|
|
:Parameters:
|
asn1Id : integer or byte
|
The universal DER tag number for this object
|
(e.g. 0x10 for a SEQUENCE).
|
If None, the tag is not known yet.
|
|
payload : byte string
|
The initial payload of the object (that it,
|
the content octets).
|
If not specified, the payload is empty.
|
|
implicit : integer or byte
|
The IMPLICIT tag number (< 0x1F) to use for the encoded object.
|
It overrides the universal tag *asn1Id*.
|
It cannot be combined with the ``explicit`` parameter.
|
By default, there is no IMPLICIT tag.
|
|
constructed : bool
|
True when the ASN.1 type is *constructed*.
|
False when it is *primitive* (default).
|
|
explicit : integer or byte
|
The EXPLICIT tag number (< 0x1F) to use for the encoded object.
|
It cannot be combined with the ``implicit`` parameter.
|
By default, there is no EXPLICIT tag.
|
Né r z1Explicit and implicit tags are mutually exclusiveé é )Ú
|
_tag_octetÚ _convertTagÚpayloadr- Ú_inner_tag_octet)r Úasn1IdrA ÚimplicitÚ constructedÚexplicitÚconstructed_bits r r! zDerObject.__init__W s± ð> >à&*DOØØ ×)Ñ)¨&Ó1à & ñ +6¡$¸4à ¨(Ð 3Ñ3Ü$ð &;ó <ð <ð Ð'à&*¨_Ñ&<¸t×?OÑ?OÐPXÓ?YÑ&YDOØ Ð)à&1°D×4DÑ4DÀXÓ4NÑ&NDOØ,;¸fÑ,DDÕ)ð '6¸Ñ&>DOr" c ó® t |« s t |« dk( rt |d « }t |« rd|cxk rdk st d« t d« |S )zCheck if *tag* is a real DER tag (5 bits).
|
Convert it from a character to number if necessary.
|
r3 r é z Wrong DER tag)r r* r r- )r Útags r r@ zDerObject._convertTag sT ô " #Ü3x 1}Ü " 3 q¡6lä" 3¨A°¬O°tªOÜ$ _Ó5Ð5ð -<Ü$ _Ó5Ð5Ø
|
r" c ól | dkD r%t | « }t t |« dz « |z S t | « S )zXBuild length octets according to BER/DER
|
definite form.
|
é r= )r r r* )r. Úencodings r Ú_definite_formzDerObject._definite_form© s8 ð
|
C<Ü#0°Ó#8Ü #¤C¨£M°CÑ$7Ó 8¸8Ñ CÐCÜF|Ð#r" c ó& | j }t | d« rGt | j « | j t | j « « z | j z }t | j « | j t |« « z |z S )z?Return this DER element, fully encoded as a binary byte string.rB )rA Úhasattrr rB rN r* r? )r Úoutput_payloads r ÚencodezDerObject.encode³ s ð "&§ ¡ ô 4Ð!3Ô4Ü&*¨4×+@Ñ+@Ó&AØ&*×&9Ñ&9¼#¸d¿l¹lÓ:KÓ&Lñ'Mà&*§l¡lñ'3Nô T__Ó-Ø ×+Ñ+¬C°Ó,?Ó@ñAà&ñ'ð (r" c óÆ |j « }|dkD rK|j |dz « }t |d « dk( r t d« t |« }|dk r t d« |S )z%Decode DER length octets from a file.rL r z$Invalid DER: length has leading zeroz5Invalid DER: length in long form but smaller than 128)r4 r1 r r- r )r Úsr. Úencoded_lengths r Ú
|
_decodeLenzDerObject._decodeLenÆ sh ð àC<Ø%&§V¡V¨F°T©MÓ%:NÜN¨1Ñ -Ó.°!Ò3Ü (Ð)OÓ PÐPÜ *¨>Ó :FØ }Ü (Ð)`Ó aÐaà r" c ó¨ t |« s t d« t |« }| j ||« |j « dkD r t d« | S )a Decode a complete DER element, and re-initializes this
|
object with it.
|
|
Args:
|
der_encoded (byte string): A complete DER element.
|
|
Raises:
|
ValueError: in case of parsing errors.
|
zInput is not a byte stringr ú-Unexpected extra data after the DER structure)r r- r Ú_decodeFromStreamr+ )r Ú der_encodedÚstrictrT s r ÚdecodezDerObject.decodeÕ sV ô # ;Ô/Ü$Ð%AÓBÐBä Ó,Ø×&Ñ& q¨&Ô1ð ×#Ñ#Ó%¨Ò)Ü$Ð%TÓUÐUà r" c óî |j « }| j || j k7 rt d« || _ | j |« }|j |« | _ t | d« r
t | j
|
« }|j « }|| j k7 r t d« | j |« }|j |« | _ |j « dkD r t d« yy)z*Decode a complete DER element from a file.NzUnexpected DER tagrB zUnexpected internal DER tagr rX )
|
r4 r? r- rV r1 rA rP r rB r+ )r rT r[ ÚidOctetr. ÚpÚ inner_octets r rY zDerObject._decodeFromStreamì sÛ ð ++-Ø??Ð.Ø $§/¡/Ò1Ü (Ð)=Ó >Ð>à&-DOØ ¨Ó+Ø vv f~ ô 4Ð!3Ô4Ü# D§L¡LÓ1AØ"#§+¡+£-KØ" d×&;Ñ&;Ò;Ü (Ð)FÓ GÐGØ !__¨QÓ /FØ#$§6¡6¨&£>DLð ×'Ñ'Ó)¨AÒ-Ü (Ð)XÓ YÐYð .ð 5r" )Nr" NFN©F) r5 r6 r7 r8 r! r@ Ú staticmethodrN rR rV r\ rY r9 r" r r r Q sE ñ ð
|
?CØ15óD ?òL
|
ð
|
ñ $ó
|
ð $ò (ò& ó ó. Zr" r c ó, e Zd ZdZddZd ZddZd Zy) r aÈ Class to model a DER INTEGER.
|
|
An example of encoding is::
|
|
>>> from Crypto.Util.asn1 import DerInteger
|
>>> from binascii import hexlify, unhexlify
|
>>> int_der = DerInteger(9)
|
>>> print hexlify(int_der.encode())
|
|
which will show ``020109``, the DER encoding of 9.
|
|
And for decoding::
|
|
>>> s = unhexlify(b'020109')
|
>>> try:
|
>>> int_der = DerInteger()
|
>>> int_der.decode(s)
|
>>> print int_der.value
|
>>> except ValueError:
|
>>> print "Not a valid DER INTEGER"
|
|
the output will be ``9``.
|
|
:ivar value: The integer value
|
:vartype value: integer
|
Nc óF t j | dd|d|« || _ y)aU Initialize the DER object as an INTEGER.
|
|
:Parameters:
|
value : integer
|
The value of the integer.
|
|
implicit : integer
|
The IMPLICIT tag to use for the encoded object.
|
It overrides the universal tag for INTEGER (2).
|
é r" FN©r r! Úvalue©r rg rD rF s r r! zDerInteger.__init__# s& ô ×"Ñ" 4¨¨s°HØ#(¨(ô4à "
|
r" c ó& | j }d| _ t t |dz « « | j z | _ d|cxk rdk r n n t d« | j z | _ d|cxk rdk rn nn|dz }it j | « S )zIReturn the DER INTEGER, fully encoded as a
|
binary string.r" éÿ r= r iÿÿÿé )rg rA r Úintr rR )r Únumbers r rR zDerInteger.encode3 s ð Ø " ØÜ#'¬¨F°S©LÓ(9Ó#:¸T¿\¹\Ñ#IDLØfÔ+¨Õ+Ü'+¨D£z°D·L±LÑ'@ ØvÔ,¨Õ,Ø ØqLFð ô !×'Ñ'¨Ó-Ð-r" c ó2 t j | ||¬« S )a Decode a DER-encoded INTEGER, and re-initializes this
|
object with it.
|
|
Args:
|
der_encoded (byte string): A complete INTEGER DER element.
|
|
Raises:
|
ValueError: in case of parsing errors.
|
©r[ ©r r\ ©r rZ r[ s r r\ zDerInteger.decodeB s ô !×'Ñ'¨¨kÀ&Ð'ÓIÐIr" c ó4 t j | ||« |rot | j « dk( r t d« t | j « dk\ r4t j d| j dd « d dk r t d« d| _ d}| j D ]: }| xj d z c_ | xj t |« z c_ |d
|
z }< | j r2t | j d « dz r| xj |z c_ yyy) z*Decode a complete DER INTEGER from a file.r z/Invalid encoding for DER INTEGER: empty payloadre z>HNr= z.Invalid encoding for DER INTEGER: leading zeror3 é rk ) r rY r* rA r- ÚstructÚunpackrg r )r rT r[ ÚbitsÚis r rY z DerInteger._decodeFromStreamO sö ô ×+Ñ+¨D°!°VÔ<áÜ4<<Ó(¨AÒ-Ü (Ð)ZÓ [Ð[Ü4<<Ó(¨AÒ-´&·-±-ÀÀdÇlÁlÐSUÐTUÐFVÓ2WÐXYÑ2ZÐ]aÒ2aÜ (Ð)YÓ ZÐZð
|
ØØ ò AØJJ #Ñ%JØJJ¤$ q£'Ñ)JØQJDð ð <<¤D¨¯ © °a© Ó$9¸DÒ$@ØJJ $Ñ&Jð %A<r" )r NNra ©r5 r6 r7 r8 r! rR r\ rY r9 r" r r r s ñ ó6 #ò .ó Jó 'r" r c ó, e Zd ZdZddZd ZddZd Zy) r
|
aR Class to model a DER-encoded BOOLEAN.
|
|
An example of encoding is::
|
|
>>> from Crypto.Util.asn1 import DerBoolean
|
>>> bool_der = DerBoolean(True)
|
>>> print(bool_der.encode().hex())
|
|
which will show ``0101ff``, the DER encoding of True.
|
|
And for decoding::
|
|
>>> s = bytes.fromhex('0101ff')
|
>>> try:
|
>>> bool_der = DerBoolean()
|
>>> bool_der.decode(s)
|
>>> print(bool_der.value)
|
>>> except ValueError:
|
>>> print "Not a valid DER BOOLEAN"
|
|
the output will be ``True``.
|
|
:ivar value: The boolean value
|
:vartype value: boolean
|
Nc óF t j | dd|d|« || _ y)a Initialize the DER object as a BOOLEAN.
|
|
Args:
|
value (boolean):
|
The value of the boolean. Default is False.
|
|
implicit (integer or byte):
|
The IMPLICIT tag number (< 0x1F) to use for the encoded object.
|
It overrides the universal tag for BOOLEAN (1).
|
It cannot be combined with the ``explicit`` parameter.
|
By default, there is no IMPLICIT tag.
|
|
explicit (integer or byte):
|
The EXPLICIT tag number (< 0x1F) to use for the encoded object.
|
It cannot be combined with the ``implicit`` parameter.
|
By default, there is no EXPLICIT tag.
|
r3 r" FNrf rh s r r! zDerBoolean.__init__ s# ô& ×Ñ4 s¨H°e¸XÔFØ
|
r" c óV | j rdnd| _ t j | « S )z9Return the DER BOOLEAN, fully encoded as a binary string.ó ÿó ©rg rA r rR r% s r rR zDerBoolean.encode s$ ð #'§*¢*w°' Ü× Ñ Ó%Ð%r" c ó0 t j | ||« S )zßDecode a DER-encoded BOOLEAN, and re-initializes this object with it.
|
|
Args:
|
der_encoded (byte string): A DER-encoded BOOLEAN.
|
|
Raises:
|
ValueError: in case of parsing errors.
|
rp rq s r r\ zDerBoolean.decode s ô × Ñ k°6Ó:Ð:r" c ó t j | ||« t | j « dk7 r t d« t | j d « dk( rd| _ yt | j d « dk( rd| _ yt d« ) z)Decode a DER-encoded BOOLEAN from a file.r3 z7Invalid encoding for DER BOOLEAN: payload is not 1 byter Frj Tz Invalid payload for DER BOOLEANN)r rY r* rA r- r rg ©r rT r[ s r rY z DerBoolean._decodeFromStream¨ sw ô ×#Ñ# D¨!¨VÔ4ä t||Ó Ò !Ü Ð VÓWÐ Wä QÓ AÒ %Ø DJÜ $,,q/Ó " dÒ *Ø DJä Ð >Ó?Ð ?r" )FNNra rx r9 r" r r
|
r
|
f s ñó2ò,&ó
|
;ó@r" r
|
c óx e Zd ZdZddZd Zd Zd Zd Zd Z d Z
|
d
|
Z d Z d Z d ZddZddZd ZddZd Zy)r aÏ Class to model a DER SEQUENCE.
|
|
This object behaves like a dynamic Python sequence.
|
|
Sub-elements that are INTEGERs behave like Python integers.
|
|
Any other sub-element is a binary string encoded as a complete DER
|
sub-element (TLV).
|
|
An example of encoding is:
|
|
>>> from Crypto.Util.asn1 import DerSequence, DerInteger
|
>>> from binascii import hexlify, unhexlify
|
>>> obj_der = unhexlify('070102')
|
>>> seq_der = DerSequence([4])
|
>>> seq_der.append(9)
|
>>> seq_der.append(obj_der.encode())
|
>>> print hexlify(seq_der.encode())
|
|
which will show ``3009020104020109070102``, the DER encoding of the
|
sequence containing ``4``, ``9``, and the object with payload ``02``.
|
|
For decoding:
|
|
>>> s = unhexlify(b'3009020104020109070102')
|
>>> try:
|
>>> seq_der = DerSequence()
|
>>> seq_der.decode(s)
|
>>> print len(seq_der)
|
>>> print seq_der[0]
|
>>> print seq_der[:]
|
>>> except ValueError:
|
>>> print "Not a valid DER SEQUENCE"
|
|
the output will be::
|
|
3
|
4
|
[4, 9, b'']
|
|
Nc óZ t j | dd|d|« |g | _ y|| _ y)aC Initialize the DER object as a SEQUENCE.
|
|
:Parameters:
|
startSeq : Python sequence
|
A sequence whose element are either integers or
|
other DER objects.
|
|
implicit : integer or byte
|
The IMPLICIT tag number (< 0x1F) to use for the encoded object.
|
It overrides the universal tag for SEQUENCE (16).
|
It cannot be combined with the ``explicit`` parameter.
|
By default, there is no IMPLICIT tag.
|
|
explicit : integer or byte
|
The EXPLICIT tag number (< 0x1F) to use for the encoded object.
|
It cannot be combined with the ``implicit`` parameter.
|
By default, there is no EXPLICIT tag.
|
é r" TN)r r! Ú_seq)r ÚstartSeqrD rF s r r! zDerSequence.__init__ä s0 ô( ×"Ñ" 4¨¨s°H¸dÀHÔMØÐ#Ø "DIà (DIr" c ó | j |= y r$ ©r
©r Úns r Ú __delitem__zDerSequence.__delitem__ s ØIIaLr" c ó | j | S r$ r r s r Ú __getitem__zDerSequence.__getitem__ s Øyy |Ð#r" c ó" || j |< y r$ r )r Úkeyrg s r Ú __setitem__zDerSequence.__setitem__ s Ø!& #r" c ó" || j || y r$ r )r rw ÚjÚsequences r Ú __setslice__zDerSequence.__setslice__ s Ø!) !Ar" c ó" | j ||
= y r$ r ©r rw r s r Ú __delslice__zDerSequence.__delslice__ s ØIIa cNr" c óH | j t d|« t d|« S r )r
Úmaxr s r Ú __getslice__zDerSequence.__getslice__ s Øyy¤ Q¨£¬3¨q°!«9Ð5Ð5r" c ó, t | j « S r$ ©r* r
r% s r Ú__len__zDerSequence.__len__ s Ü499~Ð%r" c ó< | j j |« | S r$ ©r
Úappend©r Úitems r Ú__iadd__zDerSequence.__iadd__ ó Ø × Ñ Ô&Ø r" c ó< | j j |« | S r$ r r¡ s r r zDerSequence.append r¤ r" c ó> | j j ||« | S r$ )r
Úinsert)r Úindexr¢ s r r§ zDerSequence.insert s Ø × Ñ ¨Ô-Ø r" c ón | j D cg c] }t ||« s| }}t |« S c c}w )zìReturn the number of items in this sequence that are
|
integers.
|
|
Args:
|
only_non_negative (boolean):
|
If ``True``, negative integers are not counted in.
|
)r
r r* )r r r Úitemss r ÚhasIntszDerSequence.hasInts! s5 ð %)§I¡IÖRq´¸AÐ?PÕ1QÐRÐRÜ5zÐ!ùò Ss 2¡2c ól | j xr' | j |« t | j « k( S )a© Return ``True`` if all items in this sequence are integers
|
or non-negative integers.
|
|
This function returns False is the sequence is empty,
|
or at least one member is not an integer.
|
|
Args:
|
only_non_negative (boolean):
|
If ``True``, the presence of negative integers
|
causes the method to return ``False``.)r
r« r* )r r s r Ú hasOnlyIntszDerSequence.hasOnlyInts- s* ð yyÒV T§\¡\Ð2CÓ%DÌÈDÏIÉIËÑ%VÐVr" c óT d| _ | j D ]~ }t |« r| xj |z c_ $t |« r-| xj t |« j « z c_ \| xj |j « z c_ t j | « S )zùReturn this DER SEQUENCE, fully encoded as a
|
binary string.
|
|
Raises:
|
ValueError: if some elements in the sequence are neither integers
|
nor byte strings.
|
r" )rA r
r r r rR r r¡ s r rR zDerSequence.encode: s ð # Ø IIò 6DÜ" 4Ô(Ø ¨Ñ, Ü# DÔ)Ø ¬
|
°4Ó(8×(?Ñ(?Ó(AÑA à ¨¯ © « Ñ5 ð 6ô !×'Ñ'¨Ó-Ð-r" c ó~ || _ t j | ||¬« }|r| j « s t d« |S )a9 Decode a complete DER SEQUENCE, and re-initializes this
|
object with it.
|
|
Args:
|
der_encoded (byte string):
|
A complete SEQUENCE DER element.
|
nr_elements (None or integer or list of integers):
|
The number of members the SEQUENCE can have
|
only_ints_expected (boolean):
|
Whether the SEQUENCE is expected to contain only integers.
|
strict (boolean):
|
Whether decoding must check for strict DER compliancy.
|
|
Raises:
|
ValueError: in case of parsing errors.
|
|
DER INTEGERs are decoded into Python integers. Any other DER
|
element is not decoded. Its validity is not checked.
|
ro z Some members are not INTEGERs)Ú _nr_elementsr r\ r r- )r rZ r[ Ú nr_elementsÚonly_ints_expectedr0 s r r\ zDerSequence.decodeL sB ð* %0Ô!Ü"×)Ñ)¨$° ÀFÐ)ÓKá%¨d×.>Ñ.>Ô.@Ü$Ð%DÓEÐEà r" c ó. g | _ t j | ||« t | j « }|j « dkD rË|j « t « }|j ||« |j dk7 r*| j j |j « « nRt « }|j « }|j ||¬« | j j |j « |j « dkD rËd}| j " t | j « | j v }|s!t! dt | j « z « y# t $ r% t | j « | j k( }Y Qw xY w)z+Decode a complete DER SEQUENCE from a file.r re ro TNz1Unexpected number of members (%d) in the sequence)r
r rY r rA r+ r& r? r r( r r\ rg r° r* r r- )r rT r[ r_ ÚderÚderIntÚdataÚoks r rY z DerSequence._decodeFromStreami sc ð ô ×+Ñ+¨D°!°VÔ<ô § ¡ Ó-Ø×&Ñ&Ó(¨1Ò,ØNNÔ$ä#+CØ×)Ñ)¨!¨VÔ4ð ~~¨Ò-Ø ×(Ñ(¨×)>Ñ)>Ó)@ÕAä!+£ Ø × 4Ñ 4Ó 6Ø d°6 Ô:Ø ×(Ñ(¨¯ © Ô6ð ×&Ñ&Ó(¨1Ó,ð Ø×$Ñ$Ð0ðAÜ §¡^¨t×/@Ñ/@Ð @ñ Ü$ð &8Ü:=¸d¿i¹i».ñ&Ió Jð Jð øô %ò AÜ §¡^¨t×/@Ñ/@Ñ @ðAús Ä!!E& Å&+FÆF)NNN)T)FNF)r5 r6 r7 r8 r! r r r r r r r r£ r r§ r« r rR r\ rY r9 r" r r r ¹ sZ ñ( óT )ò8 !ò $ò 'ò *ò #ò 6ò &ò ò ò ó
|
"ó Wò .ó$ ó:" Jr" r c ó e Zd ZdZddZy)r aâ Class to model a DER OCTET STRING.
|
|
An example of encoding is:
|
|
>>> from Crypto.Util.asn1 import DerOctetString
|
>>> from binascii import hexlify, unhexlify
|
>>> os_der = DerOctetString(b'\xaa')
|
>>> os_der.payload += b'\xbb'
|
>>> print hexlify(os_der.encode())
|
|
which will show ``0402aabb``, the DER encoding for the byte string
|
``b'\xAA\xBB'``.
|
|
For decoding:
|
|
>>> s = unhexlify(b'0402aabb')
|
>>> try:
|
>>> os_der = DerOctetString()
|
>>> os_der.decode(s)
|
>>> print hexlify(os_der.payload)
|
>>> except ValueError:
|
>>> print "Not a valid DER OCTET STRING"
|
|
the output will be ``aabb``.
|
|
:ivar payload: The content of the string
|
:vartype payload: byte string
|
Nc ó6 t j | d||d« y)ah Initialize the DER object as an OCTET STRING.
|
|
:Parameters:
|
value : byte string
|
The initial payload of the object.
|
If not specified, the payload is empty.
|
|
implicit : integer
|
The IMPLICIT tag to use for the encoded object.
|
It overrides the universal tag for OCTET STRING (4).
|
é FN©r r! )r rg rD s r r! zDerOctetString.__init__¬ s ô ×Ñ4 u¨h¸Õ>r" )r" N©r5 r6 r7 r8 r! r9 r" r r r s ñô: ?r" r c ó e Zd ZdZd Zy)r z"Class to model a DER NULL element.c ó6 t j | dddd« y)z$Initialize the DER object as a NULL.é r" NFr» r% s r r! zDerNull.__init__¾ s ô ×Ñ4 s¨D°%Õ8r" Nr¼ r9 r" r r r » s
|
Ù,ó9r" r c ó, e Zd ZdZddZd ZddZd Zy) r a( Class to model a DER OBJECT ID.
|
|
An example of encoding is:
|
|
>>> from Crypto.Util.asn1 import DerObjectId
|
>>> from binascii import hexlify, unhexlify
|
>>> oid_der = DerObjectId("1.2")
|
>>> oid_der.value += ".840.113549.1.1.1"
|
>>> print hexlify(oid_der.encode())
|
|
which will show ``06092a864886f70d010101``, the DER encoding for the
|
RSA Object Identifier ``1.2.840.113549.1.1.1``.
|
|
For decoding:
|
|
>>> s = unhexlify(b'06092a864886f70d010101')
|
>>> try:
|
>>> oid_der = DerObjectId()
|
>>> oid_der.decode(s)
|
>>> print oid_der.value
|
>>> except ValueError:
|
>>> print "Not a valid DER OBJECT ID"
|
|
the output will be ``1.2.840.113549.1.1.1``.
|
|
:ivar value: The Object ID (OID), a dot separated list of integers
|
:vartype value: string
|
Nc óF t j | dd|d|« || _ y)a Initialize the DER object as an OBJECT ID.
|
|
:Parameters:
|
value : string
|
The initial Object Identifier (e.g. "1.2.0.0.6.2").
|
implicit : integer
|
The IMPLICIT tag to use for the encoded object.
|
It overrides the universal tag for OBJECT ID (6).
|
explicit : integer
|
The EXPLICIT tag to use for the encoded object.
|
é r" FNrf rh s r r! zDerObjectId.__init__â s# ô ×Ñ4 s¨H°e¸XÔFØ
|
r" c ó` | j j d« D cg c] }t |« }}t |« dk r t d« |d dkD r t d« |d dk r|d dkD r t d« d |d z |d z g|dd
|
z }g }t |« D ]= }|j |d z « |d z }|s |j |d z d z « |d z }|r ? dj t |« D cg c] }t |« c}« | _ t j | « S c c}w c c}w )zCReturn the DER OBJECT ID, fully encoded as a
|
binary string.ú.re z$Not a valid Object Identifier stringr z!First component must be 0, 1 or 2r3 é' z#Second component must be 39 at mosté( NrL é r= r" ) rg Úsplitrl r* r- Úreversedr Újoinr rA r rR )r r ÚcompsÚsubcompsrM Úvs r rR zDerObjectId.encodeñ s7 ð "&§¡×!1Ñ!1°#Ó!6Ö7AQÐ7Ð7ä u:>Ü Ð CÓDÐ DØ 8a<Ü Ð @ÓAÐ AØ 8a<E !H rMÜ Ð BÓCÐ CàqM E¨!¡HÑ,Ð-°°a°b° Ñ9àÜ(Ó#ò AØ OOA HÔ %Ø !GAÚØ T¡¨TÑ 1Ô2Øaó ð ð xx´(¸8Ó2DÖ E¨Q¤ a¥Ò EÓF Ü× Ñ Ó%Ð%ùò) 8ùò& !Fs D&Ã3D+c ó0 t j | ||« S )ab Decode a complete DER OBJECT ID, and re-initializes this
|
object with it.
|
|
Args:
|
der_encoded (byte string):
|
A complete DER OBJECT ID.
|
strict (boolean):
|
Whether decoding must check for strict DER compliancy.
|
|
Raises:
|
ValueError: in case of parsing errors.
|
rp rq s r r\ zDerObjectId.decode s ô × Ñ k°6Ó:Ð:r" c ó t j | ||« t | j « }g }d}|j « rD|j « }|dz |dz z }|dz s|j |« d}|j « rDt |« dk( r t d« |d dk r d|d g|dd n#|d d k rd|d dz
|
g|dd n d
|
|d d z
|
g|dd d j |D cg c] }t |« c}« | _ yc c}w ) z,Decode a complete DER OBJECT ID from a file.r rÇ rL r= z Empty payloadrÆ Nr3 éP re rÄ ) r rY r rA r+ r4 r r* r- rÊ Ústrrg )r rT r[ r_ rÌ rÍ Úcr s r rY z DerObjectId._decodeFromStream s ô ×#Ñ# D¨!¨VÔ4ô Ó %àØ Ø× Ñ Ô Ø AØaA HÑ%AØHØ Ô"Øð × Ñ Õ ô x=AÒ Ü _Ó-Ð -à A;Ò Ø x¨{Ð+HRaLØ a[2Ò Ø x¨{¨RÑ /Ð0HRaLà x¨{¨RÑ /Ð0HRaLàXX¨xÖ 8¨!s 1vÒ 8Ó9
|
ùÒ 8s Ã#D)Ú NNra rx r9 r" r r r Ä s ñó: ò &ó4;ó :r" r c ó, e Zd ZdZddZd ZddZd Zy) r a¢ Class to model a DER BIT STRING.
|
|
An example of encoding is:
|
|
>>> from Crypto.Util.asn1 import DerBitString
|
>>> bs_der = DerBitString(b'\xAA')
|
>>> bs_der.value += b'\xBB'
|
>>> print(bs_der.encode().hex())
|
|
which will show ``030300aabb``, the DER encoding for the bit string
|
``b'\xAA\xBB'``.
|
|
For decoding:
|
|
>>> s = bytes.fromhex('030300aabb')
|
>>> try:
|
>>> bs_der = DerBitString()
|
>>> bs_der.decode(s)
|
>>> print(bs_der.value.hex())
|
>>> except ValueError:
|
>>> print "Not a valid DER BIT STRING"
|
|
the output will be ``aabb``.
|
|
:ivar value: The content of the string
|
:vartype value: byte string
|
Nc ó t j | dd|d|« t |t « r|j « | _ y|| _ y)aÉ Initialize the DER object as a BIT STRING.
|
|
:Parameters:
|
value : byte string or DER object
|
The initial, packed bit string.
|
If not specified, the bit string is empty.
|
implicit : integer
|
The IMPLICIT tag to use for the encoded object.
|
It overrides the universal tag for BIT STRING (3).
|
explicit : integer
|
The EXPLICIT tag to use for the encoded object.
|
é r" FN)r r! Ú
|
isinstancerR rg rh s r r! zDerBitString.__init__W s< ô ×Ñ4 s¨H°e¸XÔFô eYÔ 'Ø DJà DJr" c óT d| j z | _ t j | « S )zBReturn the DER BIT STRING, fully encoded as a
|
byte string.r} r~ r% s r rR zDerBitString.encodel s% ð
|
§¡Ñ+ Ü× Ñ Ó%Ð%r" c ó0 t j | ||« S )aT Decode a complete DER BIT STRING, and re-initializes this
|
object with it.
|
|
Args:
|
der_encoded (byte string): a complete DER BIT STRING.
|
strict (boolean):
|
Whether decoding must check for strict DER compliancy.
|
|
Raises:
|
ValueError: in case of parsing errors.
|
rp rq s r r\ zDerBitString.decodet s ô × Ñ k°6Ó:Ð:r" c óæ t j | ||« | j r&t | j d « dk7 r t d« d| _ | j r| j dd | _ yy)z1Decode a complete DER BIT STRING DER from a file.r zNot a valid BIT STRINGr" r3 N)r rY rA r r- rg r s r rY z DerBitString._decodeFromStream sd ô ×#Ñ# D¨!¨VÔ4à <<D § ¡ ¨a¡ Ó 1°QÒ 6Ü Ð 5Ó6Ð 6ð
|
à <<Ø a bÐ)DJð r" )r" NNra rx r9 r" r r r : s ñó8 ò*&ó ;ó *r" r c óD e Zd ZdZd dZd Zd Zd Zd Zd dZ d Z
|
d
|
Z y) r a
Class to model a DER SET OF.
|
|
An example of encoding is:
|
|
>>> from Crypto.Util.asn1 import DerBitString
|
>>> from binascii import hexlify, unhexlify
|
>>> so_der = DerSetOf([4,5])
|
>>> so_der.add(6)
|
>>> print hexlify(so_der.encode())
|
|
which will show ``3109020104020105020106``, the DER encoding
|
of a SET OF with items 4,5, and 6.
|
|
For decoding:
|
|
>>> s = unhexlify(b'3109020104020105020106')
|
>>> try:
|
>>> so_der = DerSetOf()
|
>>> so_der.decode(s)
|
>>> print [x for x in so_der]
|
>>> except ValueError:
|
>>> print "Not a valid DER SET OF"
|
|
the output will be ``[4, 5, 6]``.
|
Nc ó t j | dd|d« g | _ d| _ |r|D ] }| j |« yy)a9 Initialize the DER object as a SET OF.
|
|
:Parameters:
|
startSet : container
|
The initial set of integers or DER encoded objects.
|
implicit : integer
|
The IMPLICIT tag to use for the encoded object.
|
It overrides the universal tag for SET OF (17).
|
é r" TN)r r! r
Ú
|
_elemOctetÚadd)r ÚstartSetrD Úes r r! zDerSetOf.__init__® sL ô ×Ñ4 s¨H°dÔ;Ø ð á Ø ò Ø ñ ð r" c ó | j | S r$ r r s r r zDerSetOf.__getitem__à s Øyy|Ðr" c ó, t | j « S r$ )Úiterr
r% s r Ú__iter__zDerSetOf.__iter__Æ s ÜDIIÐ r" c ó, t | j « S r$ r r% s r r zDerSetOf.__len__É s Ü499~Ð r" c ó$ t |« rd}n+t |t « r | j }nt |d « }| j
|
|k7 r | j
|
t d« || _ || j vr | j j |« yy)zâAdd an element to the set.
|
|
Args:
|
elem (byte string or integer):
|
An element of the same type of objects already in the set.
|
It can be an integer or a DER encoded object.
|
re r Nz&New element does not belong to the set) r r× r r? r rÞ r- r
r )r ÚelemÚeos r rß z DerSetOf.addÌ s} ô dÔ ØBÜ iÔ (Ø Bäd1g Bà ??bÒ ØÐ*Ü Ð!IÓJÐJØ DOà tyyÑ Ø II× Ñ TÕ "ð !r" c ó0 t j | ||« S )aÞ Decode a complete SET OF DER element, and re-initializes this
|
object with it.
|
|
DER INTEGERs are decoded into Python integers. Any other DER
|
element is left undecoded; its validity is not checked.
|
|
Args:
|
der_encoded (byte string): a complete DER BIT SET OF.
|
strict (boolean):
|
Whether decoding must check for strict DER compliancy.
|
|
Raises:
|
ValueError: in case of parsing errors.
|
rp rq s r r\ zDerSetOf.decodeä s ô × Ñ k°6Ó:Ð:r" c ój g | _ t j | ||« t | j « }d}|j « dkD rë|j « t « }|j ||« |dk r |j }n||j k7 r t d« |dk7 r*| j j |j « « nOt « }|j |j « |« | j j |j « |j « dkD rêyy)z)Decode a complete DER SET OF from a file.éÿÿÿÿr z)Not all elements are of the same DER typere N)r
r rY r rA r+ r& r? r- r r( r r\ rg )r rT r[ r_ Ú
|
setIdOctetr´ rµ s r rY zDerSetOf._decodeFromStreamö sü ð ô ×#Ñ# D¨!¨VÔ4ô Ó %Ø
|
Ø× Ñ Ó 1Ò$Ø NNÔ ä+CØ × !Ñ ! ! VÔ ,ð A~Ø ^^
|
à § ¡ Ò/Ü$Ð%PÓQÐQð TÒ!Ø × Ñ ×!6Ñ!6Ó!8Õ9ä# Ø a× 3Ñ 3Ó 5°vÔ>Ø × Ñ § ¡ Ô.ð' × Ñ Ó 1Õ$r" c óP g }| j D ][ }t |« rt |« j « }n#t |t
|
« r|j « }n|}|j |« ] |j « dj |« | _ t
|
j | « S )zRReturn this SET OF DER element, fully encoded as a
|
binary string.
|
r" )
|
r
r r rR r× r r ÚsortrÊ rA )r Úorderedr¢ Úbyss r rR zDerSetOf.encode s ð ØIIò DÜ$Ô Ü Ó&×-Ñ-Ó/ÜD¤)Ô,ØkkmàØ NN3Õ ð ð Øxx Ó( Ü× Ñ Ó%Ð%r" )NNra ) r5 r6 r7 r8 r! r rå r rß r\ rY rR r9 r" r r r s0 ñó4 ò* ò ò ò#ó0;ò$ /óB&r" r ra )rt ÚCrypto.Util.py3compatr r r ÚCrypto.Util.numberr r Ú__all__r Úobjectr r r r
|
r r r r r r r9 r" r ú<module>rö s´ ðó. ç 9Ñ 9ç ;ò Pó+ô %&ô %ô@sZô sZôl\'ô \'ô~P@ô P@ôfRJ)ô RJôj*?Yô *?ôZ9iô 9ôs:)ô s:ôlV*9ô V*ôrU&yõ U&r"
|
