What is rskibbe.Encryption.Base64?

As the name already suggests, it is a sub-package of the „rskibbe.Encryption“ infrastructure package implementing the Base64 encryption (encoding). This means, it helps you encrypt / encode or decrypt / decode data with the Base64 algorithm. I needed some common denominator for my apps and I didn’t want to start over and over again. I didn’t want to have separated code bases and some sort of common base – so I came up with these two libraries.

Keep in mind that Base64 rather is an Encoding than an Encryption, but in terms of this lib, I called it Encryption, because you can transfer from A to B and back from B to A.

Quick example

Step 1 – Install the package

Open the NuGet Package Manager and execute the following commands (or install it by GUI). This command will install the package to enable you using its code.

Install-Package rskibbe.Encryption
Install-Package rskibbe.Encryption.Base64

Step 2 – Instant usage without DI conceptions, etc.

If you „just want to get it going“ you can – I provided a singleton property for that. Keep in mind though, that you should think about using the more DI / IoC based approach (creating and sharing instances over DI and using like the IEncryptor or inherited interfaces around your app) in bigger apps. This can be especially helpful, if you create Encoders for specific and different problems.

// encoding
// 1. using the normal version (uses UTF8 by default)
string encodedText = Base64Encryptor.Instance.Encode("hello!");

// or 2. changing the encoding globally (for the singleton instance)
Base64Encryptor.Instance.Encoding = System.Text.Encoding.<WhateverEncodingYouLike>;
string encodedText = Base64Encryptor.Instance.Encode("hello!");

// decoding
string decodedText = Base64Encryptor.Instance.Decode("aGVsbG8h");

' encoding
' 1. using the normal version (uses UTF8 by default)
Dim encodedText As String = Base64Encryptor.Instance.Encode("hello!")

' or 2. changing the encoding globally (for the singleton instance)
Base64Encryptor.Instance.Encoding = System.Text.Encoding.<WhateverEncodingYouLike>
Dim encodedText As String = Base64Encryptor.Instance.Encode("hello!")

' decoding
Dim decodedText As String = Base64Encryptor.Instance.Decode("aGVsbG8h")

Step 3 – Create an instance of the specific encryptor

As we are using the Base64 implementation as encryption algorithm, you will need to create a corresponding object instance of the class „Base64Encryptor“. You can also specify an encoding (System.TextEncoding) while constructing. The encryptor will use UTF8 as default / if not specified.

// longer version
Base64Encryptor base64Encryptor = new Base64Encryptor();

// or short..
var base64Encryptor = new Base64Encryptor();

' longer version
Dim base64Encryptor As Base64Encryptor = new Base64Encryptor()

' or short..
Dim base64Encryptor = New Base64Encryptor()

Step 4 – Using the encryptor

With our common denominator / interface coming from the base package „rskibbe.Encryption“, we can now just call the corresponding functions.

Encrypting / Encoding

Encoding raw text to their Base64 counterpart is now pretty easy as you can just call the „Encode“ method on your created „Base64Encryptor“ instance – implementing the „IEncryptor“ interface.

// having our instance from the previous examples
string plainText = "hello!";
string encodedText = base64Encryptor.Encode(plainText);

// will output "aGVsbG8h"
System.Diagnostics.Debug.WriteLine(encodedText);

' having our instance from the previous examples
Dim plainText As String = "hello!"
Dim encodedText As String = base64Encryptor.Encode(plainText)

' will output "aGVsbG8h"
System.Diagnostics.Debug.WriteLine(encodedText)

Decrypting / Decoding

Decoding is just as simple as encoding, just call the corresponding „Decode“ method being implemented from the interface as well.

// having our instance from the previous examples
string encodedText = "aGVsbG8h";
string text = base64Encryptor.Decode(encodedText);

// will output "hello!"
System.Diagnostics.Debug.WriteLine(text);

' having our instance from the previous examples
Dim encodedText As String = "aGVsbG8h"
Dim text As String = base64Encryptor.Decode(encodedText)

' will output "hello!"
System.Diagnostics.Debug.WriteLine(text)

Der Beitrag rskibbe.Encryption.Base64 – A Base64 implementation erschien zuerst auf Robert Skibbe.

What is rskibbe.Encryption?

In software development you most likely want to create a clean and easy maintainable code base. With „rskibbe.Encryption“ you create that common base infrastructure for things that depend on encryption processes like encoding / decoding. Just imagine this package being installed and telling your (for example) viewmodels or services: „Hey, you depend on something, which is able to encode / encrypt data / both“ or „Hey, you will get something, which is able to decode data“.

Write your custom implementation for that (or install the available ones) and boom – no need to have 10 different types in your projects, which all actually should refer to a common base. For sure, there will be more sub-packages later!

Quick example

Step 1 – Install the package

Open the NuGet Package Manager and execute the following commands (or install it by GUI). This command will install the package to enable you using its code.

Install-Package rskibbe.Encryption

Step 2 – Install existing or create manual implementations

Remember: „rskibbe.Encryption“ is only a base package, that is used, to create a common infrastructure between apps. There will be more sub-packages coming – but feel (of course) free to create your own implementations.

Existing implementations

If you just want to get it going with like Base64, take a look at for example „rskibbe.Encryption.Base64“ for the Base64 „IEncryptor“ interface implementation.

Custom implementation

After installing the base package, you can now start implementing the things required for the interfaces. Please make sure, to check out the detailed explanation to understand the things behind this package. There could be different approaches, like if you only want something, which is able to decode something, just implement the „IDecoder“ interface. If – on the other hand – you need something which is able to encode and decode, then implement the „IEncryptor“ interface. You could then use typical DI to inject your dependencies into the target models, services, etc.

Step 3 – Use the implementation

After you either downloaded an existing implementation like the „rskibbe.Encryption.Base64“ or implemented your own one. Create an instance and call the corresponding „Encode“, „Decode“ methods on the object.

Detailed explanation

If you take a look at the diagram / image, you can see some things explaining the library in more detail. I mean, it’s not that big anyways, but… As this is only an infrastructure, you won’t see any implementation / model classes. Only the exception classes are (more or less provided) to be directly used – the exception, hah.

Common conception:

The idea behind this package is to structure the (soon) following things when talking about encryption. Keep in mind, that the term „encryption“ isn’t to be mixed with the term „hashing“! Back to the encryption side of things, there are:

• „things“ being able to encode data
• „things“ being able to decode data
• and „things“ being able to do both tasks combined

Encoders

The most common task when talking about „encryption“ would be the encoding / encryption of provided data. So I called the thing which is able to „encode“ data – Encoder. Therefore, the „IEncoder“ interface came to life having only this one method „Encode“.

Decoders

In terms of encryption (again – not hashing!) you wouldn’t have pretty much out of it, when you can encode things but never getting them back to the original. This is where the term „Decoder“ and the corresponding interface „IDecoder“ are coming into play. As the name suggests, a decoder has only one job – decoding things! Therefore the interface „IDecoder“ came to life.

Encryptor

In the end, there will be „things“ that can do both works – encoding and also decoding. I called them „Encryptors“ in my little world here. I was racking my brain to find a better term for it, but couldn’t. I though about something like „Cypher“, „XyManager“ but these sucked even more, so…

Exceptions

For sure, there can be and will be things going wrong. Some may lead to a fatal exit of your app, some aren’t that bad. I’ve added two base classes for Exception handling, signaling: „Hey, there went something wrong encoding / decoding your provided data“. You can therefore throw an „EncodingException“ when something went wrong while encoding and a „DecodingException“ for decoding problems.

Der Beitrag rskibbe.Encryption – An infrastructure for encoding / decoding things erschien zuerst auf Robert Skibbe.