Struct DES_Generic

Source

pub struct DES_Generic<const ROUND: usize = 16, const SHIFT: u128 = 33027, const PC101: u8 = 57, const PC102: u8 = 49, const PC103: u8 = 41, const PC104: u8 = 33, const PC105: u8 = 25, const PC106: u8 = 17, const PC107: u8 = 9, const PC108: u8 = 1, const PC109: u8 = 58, const PC110: u8 = 50, const PC111: u8 = 42, const PC112: u8 = 34, const PC113: u8 = 26, const PC114: u8 = 18, const PC115: u8 = 10, const PC116: u8 = 2, const PC117: u8 = 59, const PC118: u8 = 51, const PC119: u8 = 43, const PC120: u8 = 35, const PC121: u8 = 27, const PC122: u8 = 19, const PC123: u8 = 11, const PC124: u8 = 3, const PC125: u8 = 60, const PC126: u8 = 52, const PC127: u8 = 44, const PC128: u8 = 36, const PC129: u8 = 63, const PC130: u8 = 55, const PC131: u8 = 47, const PC132: u8 = 39, const PC133: u8 = 31, const PC134: u8 = 23, const PC135: u8 = 15, const PC136: u8 = 7, const PC137: u8 = 62, const PC138: u8 = 54, const PC139: u8 = 46, const PC140: u8 = 38, const PC141: u8 = 30, const PC142: u8 = 22, const PC143: u8 = 14, const PC144: u8 = 6, const PC145: u8 = 61, const PC146: u8 = 53, const PC147: u8 = 45, const PC148: u8 = 37, const PC149: u8 = 29, const PC150: u8 = 21, const PC151: u8 = 13, const PC152: u8 = 5, const PC153: u8 = 28, const PC154: u8 = 20, const PC155: u8 = 12, const PC156: u8 = 4, const PC201: u8 = 14, const PC202: u8 = 17, const PC203: u8 = 11, const PC204: u8 = 24, const PC205: u8 = 1, const PC206: u8 = 5, const PC207: u8 = 3, const PC208: u8 = 28, const PC209: u8 = 15, const PC210: u8 = 6, const PC211: u8 = 21, const PC212: u8 = 10, const PC213: u8 = 23, const PC214: u8 = 19, const PC215: u8 = 12, const PC216: u8 = 4, const PC217: u8 = 26, const PC218: u8 = 8, const PC219: u8 = 16, const PC220: u8 = 7, const PC221: u8 = 27, const PC222: u8 = 20, const PC223: u8 = 13, const PC224: u8 = 2, const PC225: u8 = 41, const PC226: u8 = 52, const PC227: u8 = 31, const PC228: u8 = 37, const PC229: u8 = 47, const PC230: u8 = 55, const PC231: u8 = 30, const PC232: u8 = 40, const PC233: u8 = 51, const PC234: u8 = 45, const PC235: u8 = 33, const PC236: u8 = 48, const PC237: u8 = 44, const PC238: u8 = 49, const PC239: u8 = 39, const PC240: u8 = 56, const PC241: u8 = 34, const PC242: u8 = 53, const PC243: u8 = 46, const PC244: u8 = 42, const PC245: u8 = 50, const PC246: u8 = 36, const PC247: u8 = 29, const PC248: u8 = 32, const IP01: u8 = 58, const IP02: u8 = 50, const IP03: u8 = 42, const IP04: u8 = 34, const IP05: u8 = 26, const IP06: u8 = 18, const IP07: u8 = 10, const IP08: u8 = 2, const IP09: u8 = 60, const IP10: u8 = 52, const IP11: u8 = 44, const IP12: u8 = 36, const IP13: u8 = 28, const IP14: u8 = 20, const IP15: u8 = 12, const IP16: u8 = 4, const IP17: u8 = 62, const IP18: u8 = 54, const IP19: u8 = 46, const IP20: u8 = 38, const IP21: u8 = 30, const IP22: u8 = 22, const IP23: u8 = 14, const IP24: u8 = 6, const IP25: u8 = 64, const IP26: u8 = 56, const IP27: u8 = 48, const IP28: u8 = 40, const IP29: u8 = 32, const IP30: u8 = 24, const IP31: u8 = 16, const IP32: u8 = 8, const IP33: u8 = 57, const IP34: u8 = 49, const IP35: u8 = 41, const IP36: u8 = 33, const IP37: u8 = 25, const IP38: u8 = 17, const IP39: u8 = 9, const IP40: u8 = 1, const IP41: u8 = 59, const IP42: u8 = 51, const IP43: u8 = 43, const IP44: u8 = 35, const IP45: u8 = 27, const IP46: u8 = 19, const IP47: u8 = 11, const IP48: u8 = 3, const IP49: u8 = 61, const IP50: u8 = 53, const IP51: u8 = 45, const IP52: u8 = 37, const IP53: u8 = 29, const IP54: u8 = 21, const IP55: u8 = 13, const IP56: u8 = 5, const IP57: u8 = 63, const IP58: u8 = 55, const IP59: u8 = 47, const IP60: u8 = 39, const IP61: u8 = 31, const IP62: u8 = 23, const IP63: u8 = 15, const IP64: u8 = 7, const EP01: u8 = 32, const EP02: u8 = 1, const EP03: u8 = 2, const EP04: u8 = 3, const EP05: u8 = 4, const EP06: u8 = 5, const EP07: u8 = 4, const EP08: u8 = 5, const EP09: u8 = 6, const EP10: u8 = 7, const EP11: u8 = 8, const EP12: u8 = 9, const EP13: u8 = 8, const EP14: u8 = 9, const EP15: u8 = 10, const EP16: u8 = 11, const EP17: u8 = 12, const EP18: u8 = 13, const EP19: u8 = 12, const EP20: u8 = 13, const EP21: u8 = 14, const EP22: u8 = 15, const EP23: u8 = 16, const EP24: u8 = 17, const EP25: u8 = 16, const EP26: u8 = 17, const EP27: u8 = 18, const EP28: u8 = 19, const EP29: u8 = 20, const EP30: u8 = 21, const EP31: u8 = 20, const EP32: u8 = 21, const EP33: u8 = 22, const EP34: u8 = 23, const EP35: u8 = 24, const EP36: u8 = 25, const EP37: u8 = 24, const EP38: u8 = 25, const EP39: u8 = 26, const EP40: u8 = 27, const EP41: u8 = 28, const EP42: u8 = 29, const EP43: u8 = 28, const EP44: u8 = 29, const EP45: u8 = 30, const EP46: u8 = 31, const EP47: u8 = 32, const EP48: u8 = 1, const TP01: u8 = 16, const TP02: u8 = 7, const TP03: u8 = 20, const TP04: u8 = 21, const TP05: u8 = 29, const TP06: u8 = 12, const TP07: u8 = 28, const TP08: u8 = 17, const TP09: u8 = 1, const TP10: u8 = 15, const TP11: u8 = 23, const TP12: u8 = 26, const TP13: u8 = 5, const TP14: u8 = 18, const TP15: u8 = 31, const TP16: u8 = 10, const TP17: u8 = 2, const TP18: u8 = 8, const TP19: u8 = 24, const TP20: u8 = 14, const TP21: u8 = 32, const TP22: u8 = 27, const TP23: u8 = 3, const TP24: u8 = 9, const TP25: u8 = 19, const TP26: u8 = 13, const TP27: u8 = 30, const TP28: u8 = 6, const TP29: u8 = 22, const TP30: u8 = 11, const TP31: u8 = 4, const TP32: u8 = 25, const S000: u8 = 14, const S001: u8 = 0, const S002: u8 = 4, const S003: u8 = 15, const S004: u8 = 13, const S005: u8 = 7, const S006: u8 = 1, const S007: u8 = 4, const S008: u8 = 2, const S009: u8 = 14, const S010: u8 = 15, const S011: u8 = 2, const S012: u8 = 11, const S013: u8 = 13, const S014: u8 = 8, const S015: u8 = 1, const S016: u8 = 3, const S017: u8 = 10, const S018: u8 = 10, const S019: u8 = 6, const S020: u8 = 6, const S021: u8 = 12, const S022: u8 = 12, const S023: u8 = 11, const S024: u8 = 5, const S025: u8 = 9, const S026: u8 = 9, const S027: u8 = 5, const S028: u8 = 0, const S029: u8 = 3, const S030: u8 = 7, const S031: u8 = 8, const S032: u8 = 4, const S033: u8 = 15, const S034: u8 = 1, const S035: u8 = 12, const S036: u8 = 14, const S037: u8 = 8, const S038: u8 = 8, const S039: u8 = 2, const S040: u8 = 13, const S041: u8 = 4, const S042: u8 = 6, const S043: u8 = 9, const S044: u8 = 2, const S045: u8 = 1, const S046: u8 = 11, const S047: u8 = 7, const S048: u8 = 15, const S049: u8 = 5, const S050: u8 = 12, const S051: u8 = 11, const S052: u8 = 9, const S053: u8 = 3, const S054: u8 = 7, const S055: u8 = 14, const S056: u8 = 3, const S057: u8 = 10, const S058: u8 = 10, const S059: u8 = 0, const S060: u8 = 5, const S061: u8 = 6, const S062: u8 = 0, const S063: u8 = 13, const S100: u8 = 15, const S101: u8 = 3, const S102: u8 = 1, const S103: u8 = 13, const S104: u8 = 8, const S105: u8 = 4, const S106: u8 = 14, const S107: u8 = 7, const S108: u8 = 6, const S109: u8 = 15, const S110: u8 = 11, const S111: u8 = 2, const S112: u8 = 3, const S113: u8 = 8, const S114: u8 = 4, const S115: u8 = 14, const S116: u8 = 9, const S117: u8 = 12, const S118: u8 = 7, const S119: u8 = 0, const S120: u8 = 2, const S121: u8 = 1, const S122: u8 = 13, const S123: u8 = 10, const S124: u8 = 12, const S125: u8 = 6, const S126: u8 = 0, const S127: u8 = 9, const S128: u8 = 5, const S129: u8 = 11, const S130: u8 = 10, const S131: u8 = 5, const S132: u8 = 0, const S133: u8 = 13, const S134: u8 = 14, const S135: u8 = 8, const S136: u8 = 7, const S137: u8 = 10, const S138: u8 = 11, const S139: u8 = 1, const S140: u8 = 10, const S141: u8 = 3, const S142: u8 = 4, const S143: u8 = 15, const S144: u8 = 13, const S145: u8 = 4, const S146: u8 = 1, const S147: u8 = 2, const S148: u8 = 5, const S149: u8 = 11, const S150: u8 = 8, const S151: u8 = 6, const S152: u8 = 12, const S153: u8 = 7, const S154: u8 = 6, const S155: u8 = 12, const S156: u8 = 9, const S157: u8 = 0, const S158: u8 = 3, const S159: u8 = 5, const S160: u8 = 2, const S161: u8 = 14, const S162: u8 = 15, const S163: u8 = 9, const S200: u8 = 10, const S201: u8 = 13, const S202: u8 = 0, const S203: u8 = 7, const S204: u8 = 9, const S205: u8 = 0, const S206: u8 = 14, const S207: u8 = 9, const S208: u8 = 6, const S209: u8 = 3, const S210: u8 = 3, const S211: u8 = 4, const S212: u8 = 15, const S213: u8 = 6, const S214: u8 = 5, const S215: u8 = 10, const S216: u8 = 1, const S217: u8 = 2, const S218: u8 = 13, const S219: u8 = 8, const S220: u8 = 12, const S221: u8 = 5, const S222: u8 = 7, const S223: u8 = 14, const S224: u8 = 11, const S225: u8 = 12, const S226: u8 = 4, const S227: u8 = 11, const S228: u8 = 2, const S229: u8 = 15, const S230: u8 = 8, const S231: u8 = 1, const S232: u8 = 13, const S233: u8 = 1, const S234: u8 = 6, const S235: u8 = 10, const S236: u8 = 4, const S237: u8 = 13, const S238: u8 = 9, const S239: u8 = 0, const S240: u8 = 8, const S241: u8 = 6, const S242: u8 = 15, const S243: u8 = 9, const S244: u8 = 3, const S245: u8 = 8, const S246: u8 = 0, const S247: u8 = 7, const S248: u8 = 11, const S249: u8 = 4, const S250: u8 = 1, const S251: u8 = 15, const S252: u8 = 2, const S253: u8 = 14, const S254: u8 = 12, const S255: u8 = 3, const S256: u8 = 5, const S257: u8 = 11, const S258: u8 = 10, const S259: u8 = 5, const S260: u8 = 14, const S261: u8 = 2, const S262: u8 = 7, const S263: u8 = 12, const S300: u8 = 7, const S301: u8 = 13, const S302: u8 = 13, const S303: u8 = 8, const S304: u8 = 14, const S305: u8 = 11, const S306: u8 = 3, const S307: u8 = 5, const S308: u8 = 0, const S309: u8 = 6, const S310: u8 = 6, const S311: u8 = 15, const S312: u8 = 9, const S313: u8 = 0, const S314: u8 = 10, const S315: u8 = 3, const S316: u8 = 1, const S317: u8 = 4, const S318: u8 = 2, const S319: u8 = 7, const S320: u8 = 8, const S321: u8 = 2, const S322: u8 = 5, const S323: u8 = 12, const S324: u8 = 11, const S325: u8 = 1, const S326: u8 = 12, const S327: u8 = 10, const S328: u8 = 4, const S329: u8 = 14, const S330: u8 = 15, const S331: u8 = 9, const S332: u8 = 10, const S333: u8 = 3, const S334: u8 = 6, const S335: u8 = 15, const S336: u8 = 9, const S337: u8 = 0, const S338: u8 = 0, const S339: u8 = 6, const S340: u8 = 12, const S341: u8 = 10, const S342: u8 = 11, const S343: u8 = 1, const S344: u8 = 7, const S345: u8 = 13, const S346: u8 = 13, const S347: u8 = 8, const S348: u8 = 15, const S349: u8 = 9, const S350: u8 = 1, const S351: u8 = 4, const S352: u8 = 3, const S353: u8 = 5, const S354: u8 = 14, const S355: u8 = 11, const S356: u8 = 5, const S357: u8 = 12, const S358: u8 = 2, const S359: u8 = 7, const S360: u8 = 8, const S361: u8 = 2, const S362: u8 = 4, const S363: u8 = 14, const S400: u8 = 2, const S401: u8 = 14, const S402: u8 = 12, const S403: u8 = 11, const S404: u8 = 4, const S405: u8 = 2, const S406: u8 = 1, const S407: u8 = 12, const S408: u8 = 7, const S409: u8 = 4, const S410: u8 = 10, const S411: u8 = 7, const S412: u8 = 11, const S413: u8 = 13, const S414: u8 = 6, const S415: u8 = 1, const S416: u8 = 8, const S417: u8 = 5, const S418: u8 = 5, const S419: u8 = 0, const S420: u8 = 3, const S421: u8 = 15, const S422: u8 = 15, const S423: u8 = 10, const S424: u8 = 13, const S425: u8 = 3, const S426: u8 = 0, const S427: u8 = 9, const S428: u8 = 14, const S429: u8 = 8, const S430: u8 = 9, const S431: u8 = 6, const S432: u8 = 4, const S433: u8 = 11, const S434: u8 = 2, const S435: u8 = 8, const S436: u8 = 1, const S437: u8 = 12, const S438: u8 = 11, const S439: u8 = 7, const S440: u8 = 10, const S441: u8 = 1, const S442: u8 = 13, const S443: u8 = 14, const S444: u8 = 7, const S445: u8 = 2, const S446: u8 = 8, const S447: u8 = 13, const S448: u8 = 15, const S449: u8 = 6, const S450: u8 = 9, const S451: u8 = 15, const S452: u8 = 12, const S453: u8 = 0, const S454: u8 = 5, const S455: u8 = 9, const S456: u8 = 6, const S457: u8 = 10, const S458: u8 = 3, const S459: u8 = 4, const S460: u8 = 0, const S461: u8 = 5, const S462: u8 = 14, const S463: u8 = 3, const S500: u8 = 12, const S501: u8 = 10, const S502: u8 = 1, const S503: u8 = 15, const S504: u8 = 10, const S505: u8 = 4, const S506: u8 = 15, const S507: u8 = 2, const S508: u8 = 9, const S509: u8 = 7, const S510: u8 = 2, const S511: u8 = 12, const S512: u8 = 6, const S513: u8 = 9, const S514: u8 = 8, const S515: u8 = 5, const S516: u8 = 0, const S517: u8 = 6, const S518: u8 = 13, const S519: u8 = 1, const S520: u8 = 3, const S521: u8 = 13, const S522: u8 = 4, const S523: u8 = 14, const S524: u8 = 14, const S525: u8 = 0, const S526: u8 = 7, const S527: u8 = 11, const S528: u8 = 5, const S529: u8 = 3, const S530: u8 = 11, const S531: u8 = 8, const S532: u8 = 9, const S533: u8 = 4, const S534: u8 = 14, const S535: u8 = 3, const S536: u8 = 15, const S537: u8 = 2, const S538: u8 = 5, const S539: u8 = 12, const S540: u8 = 2, const S541: u8 = 9, const S542: u8 = 8, const S543: u8 = 5, const S544: u8 = 12, const S545: u8 = 15, const S546: u8 = 3, const S547: u8 = 10, const S548: u8 = 7, const S549: u8 = 11, const S550: u8 = 0, const S551: u8 = 14, const S552: u8 = 4, const S553: u8 = 1, const S554: u8 = 10, const S555: u8 = 7, const S556: u8 = 1, const S557: u8 = 6, const S558: u8 = 13, const S559: u8 = 0, const S560: u8 = 11, const S561: u8 = 8, const S562: u8 = 6, const S563: u8 = 13, const S600: u8 = 4, const S601: u8 = 13, const S602: u8 = 11, const S603: u8 = 0, const S604: u8 = 2, const S605: u8 = 11, const S606: u8 = 14, const S607: u8 = 7, const S608: u8 = 15, const S609: u8 = 4, const S610: u8 = 0, const S611: u8 = 9, const S612: u8 = 8, const S613: u8 = 1, const S614: u8 = 13, const S615: u8 = 10, const S616: u8 = 3, const S617: u8 = 14, const S618: u8 = 12, const S619: u8 = 3, const S620: u8 = 9, const S621: u8 = 5, const S622: u8 = 7, const S623: u8 = 12, const S624: u8 = 5, const S625: u8 = 2, const S626: u8 = 10, const S627: u8 = 15, const S628: u8 = 6, const S629: u8 = 8, const S630: u8 = 1, const S631: u8 = 6, const S632: u8 = 1, const S633: u8 = 6, const S634: u8 = 4, const S635: u8 = 11, const S636: u8 = 11, const S637: u8 = 13, const S638: u8 = 13, const S639: u8 = 8, const S640: u8 = 12, const S641: u8 = 1, const S642: u8 = 3, const S643: u8 = 4, const S644: u8 = 7, const S645: u8 = 10, const S646: u8 = 14, const S647: u8 = 7, const S648: u8 = 10, const S649: u8 = 9, const S650: u8 = 15, const S651: u8 = 5, const S652: u8 = 6, const S653: u8 = 0, const S654: u8 = 8, const S655: u8 = 15, const S656: u8 = 0, const S657: u8 = 14, const S658: u8 = 5, const S659: u8 = 2, const S660: u8 = 9, const S661: u8 = 3, const S662: u8 = 2, const S663: u8 = 12, const S700: u8 = 13, const S701: u8 = 1, const S702: u8 = 2, const S703: u8 = 15, const S704: u8 = 8, const S705: u8 = 13, const S706: u8 = 4, const S707: u8 = 8, const S708: u8 = 6, const S709: u8 = 10, const S710: u8 = 15, const S711: u8 = 3, const S712: u8 = 11, const S713: u8 = 7, const S714: u8 = 1, const S715: u8 = 4, const S716: u8 = 10, const S717: u8 = 12, const S718: u8 = 9, const S719: u8 = 5, const S720: u8 = 3, const S721: u8 = 6, const S722: u8 = 14, const S723: u8 = 11, const S724: u8 = 5, const S725: u8 = 0, const S726: u8 = 0, const S727: u8 = 14, const S728: u8 = 12, const S729: u8 = 9, const S730: u8 = 7, const S731: u8 = 2, const S732: u8 = 7, const S733: u8 = 2, const S734: u8 = 11, const S735: u8 = 1, const S736: u8 = 4, const S737: u8 = 14, const S738: u8 = 1, const S739: u8 = 7, const S740: u8 = 9, const S741: u8 = 4, const S742: u8 = 12, const S743: u8 = 10, const S744: u8 = 14, const S745: u8 = 8, const S746: u8 = 2, const S747: u8 = 13, const S748: u8 = 0, const S749: u8 = 15, const S750: u8 = 6, const S751: u8 = 12, const S752: u8 = 10, const S753: u8 = 9, const S754: u8 = 13, const S755: u8 = 0, const S756: u8 = 15, const S757: u8 = 3, const S758: u8 = 3, const S759: u8 = 5, const S760: u8 = 5, const S761: u8 = 6, const S762: u8 = 8, const S763: u8 = 11> { /* private fields */ }

Expand description

A DES symmetric-key algorithm for the encryption of digital data

§Note

This descryption about DES is according to big endianness. MSB (Most Significant Bit) is the first bit and LSB (Least Significant Bit) is the 64th bit in this descryption unless otherwise mentioned.

§Introduction

DES is the acronym of Data Encryption Standard. It is the symmetric key encryption/decryption algorithm. It was originally developed based on Lucifer encryption/decryption algorithm made by IBM. DES was approved as a federal standard in November 1976.

§Vulnerability

Its key length is only 56-bit. It is considered to be too short against modern computing power. Actually, in July, 1998, the DES key was broken by brute-force attack within 56 hours with a machine DES cracker (Deep Crack) made by EEF (Electronic Frontier Foundation). And, in January, 1999, Deep Crack and distributed.net broke a DES key together within 22 hours and 15 minutes.
Weak keys: 0x0000000000000000, 0x0101010101010101, 0xFFFFFFFFFFFFFFFF, 0xFEFEFEFEFEFEFEFE, 0xF1F1F1F1E0E0E0E0, 0xF0F0F0F0E1E1E1E1, 0x0E0E0E0E1F1F1F1F, 0x0F0F0F0F1E1E1E1E in little-endianness. Actually, if the parity bits in keys are ignored, the keys 0x0000000000000000 and 0x0101010101010101 are the same key. In fact, not only 0x0101010101010101 is the same key as 0x0000000000000000. 0x0100000000000000 is also the same key. All the 256 keys that have only different parity bits and all other bits same are the same key as 0x0000000000000000, too. Though only representative keys will be mentioned in this description, please keep in mind that all the 256 keys that have only different parity bits and all other bits same are the same key. And, the keys 0xFFFFFFFFFFFFFFFF and 0xFEFEFEFEFEFEFEFE are also the same key. And, The keys 0xF1F1F1F1E0E0E0E0 and 0xF0F0F0F0E1E1E1E1 are also the same key. And, the keys 0x0E0E0E0E1F1F1F1F and 0x0F0F0F0F1E1E1E1E are the same key, too. For instance, if you encrypt your data with the key 0x0000000000000000 and encrypt the output ciphertext again with the same key 0x0000000000000000, you will get the original plaintext! So, the ciphertext is only secure-looking.
Semi-week keys: The pairs (0x0E010E011F011F01, 0x010E010E011F011F), (0xF101F101E001E001, 0x01F101F101E001E0), (0xFE01FE01FE01FE01, 0x01FE01FE01FE01FE), (0xF10EF10EE01FE01F, 0x0EF10EF11FE01FE0), (0xFE0EFE0EFE1FFE1F, 0x0EFE0EFE1FFE1FFE), and (0xFEF1FEF1FEE0FEE0, 0xF1FEF1FEE0FEE0FE) in little-endianness are considered to be week. For example, if you encrypt your data with the key 0x0E010E011F011F01 and encrypt the output ciphertext again with its counterpart key 0x010E010E011F011F, you will get the original plaintext! So, the ciphertext is only secure-looking.

§Examples for Weak keys

use cryptocol::symmetric::DES;
let message = 0x1234567890ABCDEF_u64;
let mut cipher: u64;
let weak_key = [ 0x0000000000000000_u64, 0x0101010101010101, 0xFFFFFFFFFFFFFFFF, 0xFEFEFEFEFEFEFEFE, 0xF1F1F1F1E0E0E0E0, 0xF0F0F0F0E1E1E1E1, 0x0E0E0E0E1F1F1F1F, 0x0F0F0F0F1E1E1E1E];
let mut des = DES::new();
for key in weak_key
{
    println!("Weak Key:\t{:#018X}", key);
    des.set_key_u64(key);
    cipher = des.encrypt_u64(message);
    cipher = des.encrypt_u64(cipher);
 
    println!("Message =\t{:#018X}", message);
    println!("Cipher =\t{:#018X}", cipher);
    assert_eq!(message, cipher);
    println!();
}

§Examples for Semi-Weak keys

use cryptocol::symmetric::DES;
let message = 0x1234567890ABCDEF_u64;
let mut cipher: u64;
let semi_weak_key: [(u64, u64); 6] = [  (0x0E010E011F011F01, 0x010E010E011F011F),
                                        (0xF101F101E001E001, 0x01F101F101E001E0),
                                        (0xFE01FE01FE01FE01, 0x01FE01FE01FE01FE),
                                        (0xF10EF10EE01FE01F, 0x0EF10EF11FE01FE0),
                                        (0xFE0EFE0EFE1FFE1F, 0x0EFE0EFE1FFE1FFE),
                                        (0xFEF1FEF1FEE0FEE0, 0xF1FEF1FEE0FEE0FE)];
let mut des = DES::new();
for key in semi_weak_key
{
    println!("Semi-weak Key pair: {:#018X}, {:#018X}", key.0, key.1);
    des.set_key_u64(key.0);
    cipher = des.encrypt_u64(message);
    des.set_key_u64(key.1);
    cipher = des.encrypt_u64(cipher);
 
    println!("Message =\t{:#018X}", message);
    println!("Cipher =\t{:#018X}", cipher);
    assert_eq!(message, cipher);
    println!();
}

§Use of DES and its variants

This algorithm is implemented generic way. Most of the constants are implemented as generic constants. So, without changing any line of code, you can change the algorithm by changing the generic parameter. You can design and implement your own algorithm based on DES which uses Feistel structure.

§Generic Parameters

ROUND: You can determine how many times the Fiestel network will be repeated. Its maximum value is 128 and its minimum value is 0. Original DES has 16 rounds for its Feistel structure but you can increase the number of rounds up to 128 rounds, and decrease it down to 0.
SHIFT: According to the number of rounds, you have to determine SHIFT which is used for generating round keys. You can determine how many bits the half keys will be rotated left for the corresponding round in the key generator. If SHIFT is ‘0b10011001’, the half keys will be rotated left by one bit for the first round, and will be rotated left by two bits for the second round, and will be rotated left by two bits for the third round, and so on. The LSB (Least Significant Bit) is for the first round and the MSB (Most Significant Bit) is for the 128th round. 0 means that the half keys will be rotated left by two bits and 1 means that the half keys will be rotated left by one bit. Up to only ROUND bits from the LSB of SHIFT will be meaningful. For example, if ROUND is 5 and SHIFT is ‘0b10011001’, only ‘0b11001’ out of ‘0b10011001’ is meaningful. If ROUND is 16 and SHIFT is ‘0b10011001’, SHIFT will be understood to be ‘0b0000000010011001’.
PC101 ~ PC248: Permutation compression. In key generator, the 64-bit key which includes parity bits is compressed into 56-bit key by dropping all the parity bits (8th, 16th, 24th, 32th, 40th, 48th, 56th, and 64th bits) and permutating (or transposing or shuffling) all bits. They are 1-based. For this operation, PC101 ~ PC156 are used. You can change the permutation compression algorithm by changing these parameters. Note that PC101 ~ PC248 should not include 8, 16, 24, 32, 40, 48, 56, and 64 because they are all parity bits. If you include any of those numbers, the whole DES encryption/decryption algorithm is broken or unstable or collapses. Also, in key generator, 56-bit key is compressed into 48-bit key by dropping all the bits (9th, 18th, 22nd, 25th, 35th, 43rd, and 54th bits) and permutating (or transposing or shuffling) all bits. For this operation, PC201 ~ PC248 are used. You can change the permutation compression algorithm by changing these parameters. In this case, you can drop other bits intead of dropping 9th, 18th, 22nd, 25th, 35th, 43rd, and 54th bits. Dropping other bits does not kill the whole DES encryption/decryption algorithm.
IP01 ~ IP64: Inital permutation constants. They are 1-based. For example, IP01 = 58 means that the 58th bit of data is moved to the first bit of the data which is MSB at initial permutation. You can change inital permutation wire by changing these constants. However, when you change these constants, you have to remember that you should included all the bits. You cannot drop any bit. Your dropping any bit will surely kill the whole DES encryption/decryption algorithm. Final permutation constants is automatically calculated from Inital permutation constants. FP01 ~ FP64 is inverse version of IP01 ~ IP64. So, FP01 ~ FP64 will be automagically determined. You don’t have to determine them.
S000 ~ S763: S-Box constants. Its index such as 000, 212, etc. is 0-based. S0XX means S-Box 0, S1XX means S-Box 1, and so on. S000 is the first element of S-Box 0. According to the document, the input six bits determines the output of S-Box. The first and the last bit of the six bits represent in base 2 a number in the decimal range 0 to 3 (or binary 00 to 11) which is row number. The rest middle four bits represent in base 2 a number in the decimal range 0 to 15 (binary 0000 to 1111) which is column number. It is considered that the DES designers explained the S-box structure unnecessarily too complicated. The above-described S-box indexing way looks two dimensional, but actually is one dimensional. So, in this crate, S-boxes are implemented to be two-dimensional array which is an array of S-boxes. Each S-box is an array of 64 four-bit numbers. The input six-bit number is used as the index of the one-dimensional array of these 64 four-bit numbers. So, the S-box tables have been rearranged to be the one-dimensional array. You can cange S-Box by changing these constants. However, you have know that the change of these constants may hurt the security a lot. And the principle of S-box has been unknown so far.
EP01 ~ EP48: Expansion permutation constants. They are 1-based. For example, EP01 = 28 means that the 28th bit of data is moved to the first bit of the data which is MSB at expansion permutation. They expand the 32-bit right-half data from the Feistel structure of the corresponding round into 48 bits in order to perform XOR (exclusive OR) with the corresponding 48-bit round key. When you change these constants, you have to remember that you should included all the bits. You cannot drop any bit. Your dropping any bit will surely kill the whole DES encryption/decryption algorithm.
TP01 ~ TP32: Translation permutation constans. They are 1-based. For example, TP01 = 16 means that the 16th bit of data is moved to the first bit of the data which is MSB at translation permutation. You can change translation permutation wire by changing these constants. However, when you change these constants, you have to remember that you should included all the bits. You cannot drop any bit. Your dropping any bit will surely kill the whole DES encryption/decryption algorithm.

§Caution

DES is not considered to be secure anymore. So, it is wise not to use DES for serious purpose. Instead, use TDES or AES or any other equivalents. In this crate, NDES which is generalized version of TDES is provided, and AES is also provided.

§Reference

Read more about DES in brief. Watch this video and then this video in series for more (or deeper or full) understanding of DES.

§Quick Start

You have to import (use) the module DES in order to use official DES as shown in Example 1.

§Example 1

use cryptocol::symmetric::DES;

You can instantiate the DES object with u64 key as Example 2. In this case, you have to take endianness into account. In little-endianness, 0x_1234567890ABCDEF_u64 is [0xEFu8, 0xCDu8, 0xABu8, 0x90u8, 0x78u8, 0x56u8, 0x34u8, 0x12u8] while the same 0x_1234567890ABCDEF_u64 is [0x12u8, 0x34u8, 0x56u8, 0x78u8, 0x90u8, 0xABu8, 0xCDu8, 0xEF_u64] in big-endianness. The instantiated object should be mutable.

§Example 2

use cryptocol::symmetric::DES;
let key = 0x_1234567890ABCDEF_u64;
let mut _a_des = DES::new_with_key_u64(key);

Also, you can instantiate the DES object with [u8; 8] key as shown in Example 3. In this case, you don’t have to take endianness into account. The instantiated object should be mutable.

§Example 3

use cryptocol::symmetric::DES;
let key = [0xEFu8, 0xCDu8, 0xABu8, 0x90u8, 0x78u8, 0x56u8, 0x34u8, 0x12u8];
let mut _a_des = DES::new_with_key(key);

You can instantiate the DES object without key and set a u64 key later as shown in Example 4 or a [u8; 8] key later as shown in Example 5.

§Example 4

use cryptocol::symmetric::DES;
let mut a_des = DES::new();
let key = 0x_1234567890ABCDEF_u64;
a_des.set_key_u64(key);

§Example 5

use cryptocol::symmetric::DES;
let mut a_des = DES::new();
let key = [0xEFu8, 0xCDu8, 0xABu8, 0x90u8, 0x78u8, 0x56u8, 0x34u8, 0x12u8];
a_des.set_key(key);

Now, you can freely use any operation mode. This crate provide ECB (Electronic CodeBook), CBC(Cipher Block Chaining), PCBC (Propagation Cipher Block Chaining), CFB (Cipher FeedBack) OFB (Output FeedBack), and CTR (CounTeR). You can choose the way of padding bits according to either PKCS #7 or ISO 7816-4. So, you can import (use) one of the following traits: ECB_PKCS7, ECB_ISO, CBC_PKCS7, CBC_ISO, PCBC_PKCS7, PCBC_ISO, CFB, OFB, and CTR. The following example 6 shows the case that you choose CBC operation mode and padding bits according to PKCS #7.

§Example 6

use std::io::Write;
use std::fmt::Write as _;
use cryptocol::symmetric::{ DES, CBC_PKCS7 };
 
let mut a_des = DES::new_with_key([0xEFu8, 0xCDu8, 0xABu8, 0x90u8, 0x78u8, 0x56u8, 0x34u8, 0x12u8]);
let message = "In the beginning God created the heavens and the earth.";
println!("M =\t{}", message);
let iv = 0x_FEDCBA0987654321_u64;
println!("IV =\t{}", iv);
let mut cipher = Vec::<u8>::new();
a_des.encrypt_str_into_vec(iv, message, &mut cipher);
print!("C =\t");
for c in cipher.clone()
    { print!("{:02X} ", c); }
println!();
let mut txt = String::new();
for c in cipher.clone()
    { write!(txt, "{:02X} ", c); }
assert_eq!(txt, "4B B5 ED DC A0 58 7E 6D 6C 3B A2 00 38 C3 D4 29 42 B1 CF 0D E9 FA EA 11 11 6B C8 30 73 39 DD B7 3F 96 9B A3 76 05 34 7E 64 2F D4 CC B2 68 33 64 C5 9E EF 01 A9 4A FD 5B ");
 
let mut recovered = String::new();
a_des.decrypt_vec_into_string(iv, &cipher, &mut recovered);
println!("B (16 rounds) =\t{}", recovered);
assert_eq!(recovered, "In the beginning God created the heavens and the earth.");
assert_eq!(recovered, message);
println!();

You can modify the DES encryption/decryption algorithm as you want. All the constants are implemented as generic parameters. For instance, you can change S-box, the number of rounds of Feistel network, the number of shift-left in round key generators, etc. The following Example 7 shows the variation of DES which has 128 rounds instead of 16 rounds.

§Example 7

use std::io::Write;
use std::fmt::Write as _;
use cryptocol::symmetric::{ DES_Expanded, CBC_PKCS7 };
 
let mut a_des = DES_Expanded::<128, 0x_8103_8103_8103_8103_8103_8103_8103_8103_u128>::new_with_key_u64([0xEFu8, 0xCDu8, 0xABu8, 0x90u8, 0x78u8, 0x56u8, 0x34u8, 0x12u8]);
let message = "In the beginning God created the heavens and the earth.";
println!("M =\t{}", message);
let iv = 0x_FEDCBA0987654321_u64;
println!("IV =\t{}", iv);
let mut cipher = Vec::<u8>::new();
a_des.encrypt_str_into_vec(iv, message.as_ptr(), message.len() as u64, &mut cipher);
print!("C =\t");
for c in cipher.clone()
    { print!("{:02X} ", c); }
println!();
let mut txt = String::new();
for c in cipher.clone()
    { write!(txt, "{:02X} ", c); }
assert_eq!(txt, "0B EA 6B BC 68 F9 B0 3E 7D AF DE 71 9C 08 AA 16 42 40 1C C8 DC 40 51 C6 8D D4 E7 D2 0B A4 F2 09 02 02 C2 6E 99 BC 9E 2A F4 11 7E 48 A7 ED 76 70 C6 9D C6 BD A6 9B 58 8B ");
 
let mut recovered = String::new();
a_des.decrypt_vec_into_string(iv, &cipher, &mut recovered);
println!("B =\t{}", recovered);
assert_eq!(recovered, "In the beginning God created the heavens and the earth.");
assert_eq!(recovered, message);

§Notice for Practical Use

Now, you can freely use any methods with any paddings in any operation modes.

This crate provides six operation modes: ECB, CBC, PCBC, CFB, OFB, and CTR.
This crate provides two padding ways: ISO 7816-4 and PKCS #7.
The operation modes ECB, CBC and PCBC requires padding bytes.
You can combine three operation modes and two padding ways.
The operation modes CFB, OFB, and CTR does not require padding bytes.
The traits that implements combination of operation modes and padding ways are provided such as ECB_PKCS7, ECB_ISO, CBC_PKCS7, CBC_ISO, PCBC_PKCS7, and PCBC_ISO.
You can find detaild instructions and their helpful examples if you go through those links.

In summary,

	padding PKCS7	padding ISO	no padding
ECB	ECB_PKCS7	ECB_ISO
CBC	CBC_PKCS7	CBC_ISO
PCBC	PCBC_PKCS7	PCBC_ISO
CFB			CFB
OFB			OFB
CTR			CTR

Struct DES_Generic Copy item path

§Note

§Introduction

§Vulnerability

§Examples for Weak keys

§Examples for Semi-Weak keys

§Use of DES and its variants

§Generic Parameters

§Caution

§Reference

§Quick Start

§Example 1

§Example 2

§Example 3

§Example 4

§Example 5

§Example 6

§Example 7

§Notice for Practical Use

Implementations§

pub fn new() -> Self

§Features

§Example 1

§For more examples,

pub fn new_with_key(key: [u8; 8]) -> Self

§Arguments

§Features

§Example 1 for normal case

§For more examples,

pub fn new_with_key_u64(key: u64) -> Self

§Arguments

§Features

§Example 1 for normal case

§For more examples,

pub fn encryptor_with_key(key: [u8; 8]) -> Self

§Arguments

§Features

§Example 1

§For more examples,

pub fn encryptor_with_key_u64(key: u64) -> Self

§Arguments

§Features

§Example 1

§For more examples,

pub fn decryptor_with_key(key: [u8; 8]) -> Self

§Arguments

§Features

§Example 1

§For more examples,

pub fn decryptor_with_key_u64(key: u64) -> Self

§Arguments

§Features

§Example 1

§For more examples,

pub fn get_key(&mut self) -> [u8; 8]

§Output

§Example

pub fn get_key_u64(&self) -> u64

§Output

§Example

pub fn set_key(&mut self, key: [u8; 8])

§Arguments

§Features

§Example 1 for normal case

§For more examples,

pub fn set_key_u64(&mut self, key: u64)

§Arguments

§Features

§Example 1 for normal case

§For more examples,

pub fn turn_inverse(&mut self)

§Features

§Example 1

§For more examples,

pub fn turn_encryptor(&mut self)

§Features

§Example 1

§For more examples,

pub fn turn_decryptor(&mut self)

§Features

Struct DES_Generic

fn encrypt( &mut self, iv: u64, message: const u8, length_in_bytes: u64, cipher: mut u8, ) -> u64

fn decrypt( &mut self, iv: u64, cipher: const u8, length_in_bytes: u64, message: mut u8, ) -> u64

fn encrypt_into_array<U, const N: usize>( &mut self, iv: u64, message: *const u8, length_in_bytes: u64, cipher: &mut [U; N], ) -> u64
where U: SmallUInt,

fn encrypt_into_vec<U>( &mut self, iv: u64, message: *const u8, length_in_bytes: u64, cipher: &mut Vec<U>, ) -> u64
where U: SmallUInt,

fn decrypt_into_array<U, const N: usize>( &mut self, iv: u64, cipher: *const u8, length_in_bytes: u64, message: &mut [U; N], ) -> u64
where U: SmallUInt,

fn encrypt_str_into_vec<U>( &mut self, iv: T, message: &str, cipher: &mut Vec<U>, ) -> u64
where U: SmallUInt,

fn encrypt_str_into_array<U, const N: usize>( &mut self, iv: T, message: &str, cipher: &mut [U; N], ) -> u64
where U: SmallUInt,