First message in 5 minutes

Send an encrypted message to one recipient, and let Secure Exchanges send them the email.

Prerequisites

The package for your language installed: Choose your package.
Your three preview credentials: Credentials and environments.

The complete code

using System;
using System.Collections.Generic;
using SecureExchangesSDK.Helpers;
using SecureExchangesSDK.Models.Args;
using SecureExchangesSDK.Models.Entity;
using SecureExchangesSDK.SecureExchanges;

internal static class FirstMessage
{
    private static void Main()
    {
        // Your credentials come from your secret store, never from code.
        Guid serial = ReadSecret("SecureExchanges:Serial");
        Guid apiUser = ReadSecret("SecureExchanges:ApiUser");
        Guid apiPassword = ReadSecret("SecureExchanges:ApiPassword");

        // Production. For the preview environment, see "Credentials and environments".
        var endpoint = new Uri("https://www.secure-exchanges.com/_api/0217/0217.asmx");

        var recipients = new List<RecipientInfo>
        {
            new RecipientInfo { Email = "recipient@example.com" }
        };

        var args = new MutliRecipientArgs(
            endPointUri: endpoint, serial: serial, user: apiUser, psw: apiPassword,
            recipients: recipients,
            message: "Hello, here is a secure message.",
            subject: "Confidential message",
            password: null, filesList: null,
            sendMode: SendMethodEnum.onlyEmail,
            getBackHtml: false,          // Secure Exchanges sends the email
            showSubject: true,           // obsolete, no effect, but required by the constructor
            getNotify: true,
            cultureID: "en-CA",
            maximumOpenTime: 5,          // number of allowed openings
            minutesExpiration: 1440);    // 24 hours

        var response = MessageHelper.MultiRecipientMessage(args);

        // The link given to the recipient grants access to the message: do not log it.
        if (response.Status == 200)
            Console.WriteLine($"Sent to {response.RecipientsAnswer.Count} recipient(s).");
        else
            Console.WriteLine($"Failed, status {response.Status}");   // see Status codes
    }

    private static Guid ReadSecret(string name)
    {
        // Replace with a read from your secret manager (Azure Key Vault, etc.).
        throw new NotImplementedException(name);
    }
}

"""First message: encrypted message to one recipient, email sent by Secure Exchanges."""

import uuid

from secure_exchanges_sdk.client import SecureExchangesClient, SEMSClient
from secure_exchanges_sdk.helpers.message_helper import MessageHelper
from secure_exchanges_sdk.helpers.settings_helper import SettingsHelper
from secure_exchanges_sdk.models.entity.recipient_info import RecipientInfo


def read_secret(name: str) -> uuid.UUID:
    """Replace with a read from your secret manager (Azure Key Vault, etc.)."""
    raise NotImplementedError(name)


def main() -> None:
    cfg = SettingsHelper.configure_preview()  # configure_production() in production
    client = SecureExchangesClient(cfg["api_endpoint"])
    sems_client = SEMSClient(cfg["sems_endpoint"])

    answer = MessageHelper.multi_recipient_message(
        api_client=client,
        sems_client=sems_client,
        serial=read_secret("SecureExchanges:Serial"),
        api_user=read_secret("SecureExchanges:ApiUser"),
        api_password=read_secret("SecureExchanges:ApiPassword"),
        recipients=[RecipientInfo(email="recipient@example.com")],
        message="<p>Hello, here is a secure message.</p>",
        subject="Confidential message",
        culture_id="en-CA",
        get_back_html=False,  # Secure Exchanges sends the email
        maximum_open_time=5,  # 1 by default
    )

    # The link given to the recipient grants access to the message: do not log it.
    if answer.status == 200:
        print(f"Sent to {len(answer.recipients_answer)} recipient(s).")
    else:
        print(f"Failed, status {answer.status}")  # see Status codes


if __name__ == "__main__":
    main()

<?php

declare(strict_types=1);

require __DIR__ . '/vendor/autoload.php';

use SecureExchanges\SDK\Client\SecureExchangesClient;
use SecureExchanges\SDK\Client\SEMSClient;
use SecureExchanges\SDK\Helpers\MessageHelper;
use SecureExchanges\SDK\Helpers\SettingsHelper;
use SecureExchanges\SDK\Models\Entity\RecipientInfo;

/** Replace with a read from your secret manager (Azure Key Vault, etc.). */
function readSecret(string $name): string
{
    throw new RuntimeException($name);
}

$endpoints = SettingsHelper::configurePreview();   // configureProduction() in production
$client = new SecureExchangesClient($endpoints['apiEndpoint']);
$sems = new SEMSClient($endpoints['semsEndpoint']);

$answer = MessageHelper::multiRecipientMessage(
    apiClient: $client,
    serial: readSecret('SecureExchanges:Serial'),
    apiUser: readSecret('SecureExchanges:ApiUser'),
    apiPassword: readSecret('SecureExchanges:ApiPassword'),
    recipients: [new RecipientInfo(email: 'recipient@example.com')],
    message: 'Hello, here is a secure message.',
    subject: 'Confidential message',
    getBackHtml: false,      // Secure Exchanges sends the email
    cultureId: 'en-CA',
    maximumOpenTime: 5,      // 1 by default
    semsClient: $sems,
);

// The link given to the recipient grants access to the message: do not log it.
if ($answer->status === 200) {
    echo 'Sent to ' . count($answer->recipientsAnswer ?? []) . " recipient(s).\n";
} else {
    echo 'Failed, status ' . $answer->status . "\n";   // see Status codes
}

Important

Who sends the email to the recipient? With getBackHtml set to false, Secure Exchanges sends it. With true, the SDK returns the email as HTML and your application must send it.

Warning

true is the default value. If your recipient receives nothing, check this option first.

Check that it works

The status returned by MultiRecipientMessage must be 200. The recipient receives an email with their link and reads the message on the Secure Exchanges secure page.