Template:Infobox encryption method: Difference between revisions

Content deleted Content added
add "series" field; other changes related to the creation of template:infobox cryptographic hash function
top: wikilink
 
(34 intermediate revisions by 16 users not shown)
Line 1:
{|{ class="infobox" style="width: 23em;"
| title = {{{name|<includeonly>{{PAGENAMEBASE}}</includeonly>}}}
|colspan="2" style="text-align: center; font-size: larger; padding-bottom: 8px" | '''{{{name}}}'''
| image = {{#invoke:InfoboxImage|InfoboxImage|image={{{image|}}}|size={{{image size|{{{image_size|{{{imagesize|}}}}}}}}}|alt={{{alt|}}}}}
|-
| caption = {{{caption|}}}
{{#if:{{{image<includeonly>|</includeonly>}}}|
<!-- -->{{!}} colspan=2 style="text-align:center;" {{!}}
{{{image<includeonly>|</includeonly>}}}
<div><small>{{{caption}}}</small></div>
}}
|-
{{#if:{{{designers<includeonly>|</includeonly>}}}{{{publish date|}}}{{{series|}}}{{{derived from|}}}{{{derived to|}}}{{{related to|}}}{{{certification|}}} |
<!-- -->! colspan=2 style="background: lightsteelblue; text-align: center; vertical-align: middle;" {{!}} General
}}
|-
{{#if:{{{designers<includeonly>|</includeonly>}}}|
<!-- -->! Designer(s):
<!-- -->{{!}} {{{designers}}}
}}
|-
{{#if:{{{publish date<includeonly>|</includeonly>}}}|
<!-- -->! First published:
<!-- -->{{!}} {{{publish date}}}
}}
|-
{{#if:{{{series<includeonly>|</includeonly>}}}|
<!-- -->! Series:
<!-- -->{{!}} {{{series}}}
}}
|-
{{#if:{{{derived from<includeonly>|</includeonly>}}}|
<!-- -->! Derived from:
<!-- -->{{!}} {{{derived from}}}
}}
|-
{{#if:{{{derived to<includeonly>|</includeonly>}}}|
<!-- -->! Successor(s):
<!-- -->{{!}} {{{derived to}}}
}}
|-
{{#if:{{{related to<includeonly>|</includeonly>}}}|
<!-- -->! Related to:
<!-- -->{{!}} {{{related to}}}
}}
|-
{{#if:{{{certification<includeonly>|</includeonly>}}}|
<!-- -->! Certification:
<!-- -->{{!}} {{{certification}}}
}}
|-
{{#if:{{{key size<includeonly>|</includeonly>}}}{{{security claim|}}}{{{block size|}}}{{{structure|}}}{{{rounds|}}} |
<!-- -->! colspan=2 style="background: lightsteelblue; text-align: center; vertical-align: middle;" {{!}} Cipher detail
}}
|-
{{#if:{{{key size<includeonly>|</includeonly>}}}|
<!-- -->! [[key size|Key size(s)]]:
<!-- -->{{!}} {{{key size}}}
}}
|-
{{#if:{{{security claim<includeonly>|</includeonly>}}}|
<!-- -->! [[security claim|Security claim(s)]]:
<!-- -->{{!}} {{{security claim}}}
}}
|-
{{#if:{{{block size<includeonly>|</includeonly>}}}|
<!-- -->! [[block size (cryptography)|Block size(s)]]:
<!-- -->{{!}} {{{block size}}}
}}
|-
{{#if:{{{structure<includeonly>|</includeonly>}}}|
<!-- -->! Structure:
<!-- -->{{!}} {{{structure}}}
}}
|-
{{#if:{{{rounds<includeonly>|</includeonly>}}}|
<!-- -->! Rounds:
<!-- -->{{!}} {{{rounds}}}
}}
|-
{{#if:{{{cryptanalysis<includeonly>|</includeonly>}}}|
<!-- -->! colspan=2 style="background: lightsteelblue; text-align: center; vertical-align: middle;" {{!}} Best public [[cryptanalysis]]
<!-- -->{{!}}-
<!-- -->{{!}} colspan=2 {{!}} {{{cryptanalysis}}}
}}
|}<!--
 
| header1 = {{#if:{{{designers|}}}{{{publish date|}}}{{{series|}}}{{{derived from|}}}{{{derived to|}}}{{{related to|}}}{{{certification|}}}|General}}
--><includeonly>[[Category:Block ciphers]]</includeonly><noinclude>
| label2 = Designers
==Usage==
| data2 = {{{designers|}}}
<pre>
| label3 = First published
{{Infobox block cipher
| namedata3 = {{{publish = date|}}}
| image label4 = Series
| caption data4 = {{{series|}}}
| label5 = Derived from
<!-- General -->
| designersdata5 = {{{derived from|}}}
| publishlabel6 date = Successors
| seriesdata6 = {{{derived = to|}}}
| derivedlabel7 from = Related&nbsp;to
| deriveddata7 to = {{{related to|}}}
| related tolabel8 = Certification
| data8 = {{{certification|}}}
| certification =
<!-- Cipher detail -->
| key size =
| security claim =
| block size =
| structure =
| rounds =
| cryptanalysis =
}}
</pre>
===Description of fields===
(See [[Template talk:Infobox block cipher|talk page]] for an example)
 
| header9 = {{#if:{{{digest size|}}}{{{key size|}}}{{{security claim|}}}{{{block size|}}}{{{state size|}}}{{{structure|}}}{{{rounds|}}}|{{#if:{{{key size|}}}{{{block size|}}}|Cipher detail|Detail}} }}
All fields except for ''name'' are optional.
| label10 = [[Cryptographic hash function|Digest size]]s
 
| data10 = {{{digest size|}}}
*'''name''': Name of the block cipher, or preferably the abbreviation if the expansion contains multiple words and would not fit well.
| label11 = [[Key size]]s
*'''image''': An illustrative image for the block cipher; typically this would contain the cipher's Feistel function for Feistel-structured ciphers.
| data11 = {{{key size|}}}
**'''caption''': (Only if the image field is specified) caption for the image.
| label12 = Security claims
 
| data12 = {{{security claim|}}}
;General
| label13 = [[Block size (cryptography)|Block size]]s
*'''designers''': Names of the designers/authors of the block cipher, separated by commas. Should not contain organization names ''unless'' names of the real authors are unknown. The names should be linked if articles about them exist.
| data13 = {{{block size|}}}
*'''publish date''': Date that the block cipher was first presented. If the exact date is unknown, this should at least contain the year number.
| label14 = State size
*'''series''': A comma-separated list of hash functions in a series, usually named similarly. <!-- For example, ... -->
| data14 = {{{state size|}}}
*'''derived from''': A comma-separated list of block ciphers that inspired the design of the subject block cipher.
| label15 = Structure
*'''derived to''': A comma-separated list of block ciphers whose design was inspired by the subject block cipher.
| data15 = {{{structure|}}}
*'''related to''': A list of block ciphers that are otherwise related to the subject. This field should be used minimally, and only when the relation is clearly remarkable.
| label16 = [[Round (cryptography)|Rounds]]
*'''certification''': Cryptography expert groups that have selected or recommended this algorithm. For example, "[[AES finalist]]", "[[NESSIE]]", "[[CRYPTREC]]"
| data16 = {{{rounds|}}}
 
| label17 = Speed
;Cipher detail
| data17 = {{{speed|}}}
*'''key size''': Key size(s) that the block cipher was originally designed to operate with, in bits. Should contain the suffix "bits". May contain multiple sizes. For example, AES submissions would have "128, 192 or 256 bits"
*'''security claim''': Security claims(s) that the block cipher was originally designed to achieve with, in bits. Should contain the suffix "bits". May contain multiple sizes. For example, submissions would have "128, 192 or 256 bits"
*'''block size''': Size(s) of the input and output blocks of the block cipher. Should contain the suffix "bits". May contain multiple sizes.
*'''structure''': If the cipher follows a common structure. Typical ciphers should have "[[Feistel network]]" or "[[Substitution-permutation network]]" here.
*'''rounds''': The number(s) of rounds the cipher was originally designed to work with. May contain several values.
*'''cryptanalysis''': The best-known cryptanalysis for the subject cipher. Should contain a brief overview of the vulnerabilities and a [[WP:FOOT|footnote]] link to the reference.
 
=== Extra features ===
 
* Articles that use this template are automatically included in the [[:Category:Block ciphers]].
 
==See also==
* [[Template:Crypto block|<nowiki>{{crypto navbox | block}}</nowiki>]]: a navigation box for block ciphers
* [[Template:Infobox cryptographic hash function|<nowiki>{{infobox cryptographic hash function}}</nowiki>]]: a similar infobox for hash functions
 
 
{{DEFAULTSORT:Block cipher}}
 
[[Category:Cryptography templates]]
[[Category:Templates using ParserFunctions]]
[[Category:Technology infobox templates]]
 
| header18 = {{#if:{{{cryptanalysis|}}}|Best public [[cryptanalysis]]}}
| below = {{{cryptanalysis|}}}
| belowstyle = line-height: 1.25em; text-align: left
}}<includeonly>{{#ifeq:{{NAMESPACE}}|{{ns:0}}| {{#if:{{{digest size|}}}|[[Category:Cryptographic hash functions]]|{{#if:{{{block size|}}}|[[Category:Block ciphers]]|{{#if:{{{state size|}}}|[[Category:Stream ciphers]]}} }} }} }}</includeonly><noinclude>{{documentation}}<!-- Please add metadata to the <includeonly> section on the /doc subpage - thanks! -->
</noinclude>