Contact
Newsletter
Schedule Consultation

Secure file handling with C#

How to use the C# vendor assembly

For reading EWU (External Editing Work Unit) files and creating ERU (External Editing Response Unit) files there are the vendor-specific assemblies.

Each vendor gets his own assembly for his Trusted Across Integration Solution which contains the secret encryption keys for reading and writing the files.

Interfaces and classes

There are two main interfaces

IReader

/// <summary>/// The Reader interface./// </summary>publicinterface IReader
{/// <summary>/// Opens a file to read an encrypted content from./// </summary>/// <param name="inputFile">/// The input file./// </param>/// <returns>/// The <see cref="Stream"/> stream to read a decrypted content from./// </returns> 
    Stream OpenFile(string inputFile);}

IWriter

/// <summary>/// The Writer interface./// </summary>  public interface IWriter{/// <summary>/// Creates a file to write an encrypted content to./// </summary>/// <param name="outputFile">/// The output file./// </param>/// <returns>/// The <see cref="Stream"/> stream to write a content to encrypt./// </returns>
    Stream CreateFile(string outputFile);}

Factory

To get an instance of an interface there is a factory class

/// <summary>///The factory./// </summary>  public static class Factory{/// <summary>/// Creates the reader instance./// </summary>/// <returns>/// The <see cref="IReader"/> reader instance./// </returns>publicstatic IReader CreateReader();/// <summary>/// Creates the writer instance./// </summary>/// <returns>/// The <see cref="IReader"/> writer instance./// </returns>publicstatic IWriter CreateWriter();}

How to read file exports from Across

  1. To read a file exported from Across, do the following:
  2. Create an instance of IReader.
  3. Call OpenFile with a path of the file as inputFile parameter.
  4. Read from Stream returned from the method.
  5. You read a raw XLIFF content from the stream.

How to write files to import into Across

  1. To write a file which will be imported into Across, do the following:
  2. Create an instance of IWriter.
  3. Call CreateFile with a path of the file as outputFile parameter.
  4. Write into Stream returned from the method.
  5. You write a raw XLIFF content to the stream.