Network

• Outgoing TCP conncections
• Outgoing TLS conncections
• UDP sockets

Parameters

Return value

// Establish an outgoing TCP connection, and close it again.
Network.socket("tcp")
    .connect("10.0.0.1", 80)
    .onconnect(function(socket) {
        socket.close();
    });

// Establish an outgoing TLS connection, and close it again.
Network.socket("tcp")
    .connect("10.0.0.1", 443)
    .onconnect(function(socket) {
        socket.close();
    });

// Receive datagrams on UDP port 8000 and send them back to the original sender
Network.socket("udp", null, "8000")
    .onbind(function(socket, addr, port) {
        socket.recv(1024, true);
    });
    .onrecv(function(socket, data, addr, port) {
        socket.send(data, addr, port);
        socket.recv(1024, true);
    });

• Incoming TCP connections
• Incoming TLS connections

Parameters

Return value

// TCP server listening on port 80 that rejects incoming connections right away
Network.server("tcp", null, 80)
    .onsocket(function(server, socket, addr, port) {
        socket.close();
    });

// TLS server listening on port 443 that rejects incoming connections right away
Network.server("tls", null, 443)
    .onsocket(function(server, socket, addr, port) {
        socket.close();
    });

Return value

// Write the addresses of the local network interfaces to the log
var addrs = Network.localAddresses();
log("local addresses:");
addrs.forEach(function(a) {
    log("   " + a.addr);
});

// Bind a TLS server on the first interface
var addrs = Network.localAddresses();

if (addrs.length) {
    Network.server("tls", addrs[0].addr, 443, addrs[0].ipv6)
        .onsocket(function(server, socket, addr, port) {
            // handle connection using the socket object
        });
}

Return value

// Write the MAC address of the AP to the log
var mac = Network.macAddress();
log("mac address: " + mac);

• if you want to configure a custom certificate.
• if you want to use different certificates for different TLS connections.

Parameters

Return value

// change the default certificate for all TLS connections
Network.socketContext().setCertificate(null, customCertPemFile);

// LDAPS client socket using a separate context with a specific certificate
Network.socketContext("ldaps").setCertificate("client", ldapsCertPemFile);

Network.socket("tls", null, 0, false, "ldaps")
    .connect("10.0.0.1", 389)
    .onconnect(function(socket) {
        // do something with the connection
    });

Parameters

Return value

// Establish a TCP connection to 10.0.0.1:80
Network.socket("tcp")
    .connect("10.0.0.1", 80)
    .onconnect(function(socket) {
        // do something with the connection
    });

Parameters

Return value

// Send a UDP datagram containing a null byte to 10.0.0.1:1000
socket.send(new Uint8Array([ 0x00 ]), "10.0.0.1", 1000);

// Send a HTTP request on a TCP connection
var request = Encoding.stringToBin(
    "GET / HTTP/1.1\r\n" +
    "Host: www.example.com\r\n" +
    "Connection: close\r\n" +
    "\r\n"
);
            
socket.send(request);

Parameters

Return value

 // receive excactly 5 bytes
socket.recv(5)
    .onrecv(function(socket, data) {
        // data.length == 5
    });

 // receive up to 1024 bytes
socket.recv(1024, true)
    .onrecv(function(socket, data) {
        // data.length <= 1024
    });

Return value

socket.close();

Parameters

Return value

 // Create a UDP socket and write the bound port to the log
Network.socket("udp")
    .onbind(function(socket, addr, port) {
        log("socket bound to port UDP/" + port);
    });

Parameters

Return value

// Establish a TCP connection to 10.0.0.1:80
Network.socket("tcp")
    .connect("10.0.0.1", 80)
    .onconnect(function(socket, addr, port) {
        log("connected to " + addr + ":" + port);
    });

Parameters

Return value

// receive data and write it to the log
socket.recv(1024, true)
    .onrecv(function(socket, data) {
        log("onrecv:");
        hexdump(data);
        socket.recv(1024, true);
    });

// Receive datagrams on UDP port 8000 and send them back to the original sender
Network.socket("udp", null, "8000")
    .onbind(function(socket, addr, port) {
        socket.recv(1024, true);
    });
    .onrecv(function(socket, data, addr, port) {
        socket.send(data, addr, port);
        socket.recv(1024, true);
    });

Parameters

Return value

socket.send(new Uint8Array([0]))
    .onsend(function(socket, data) {
        // data has been sent, ready to send the next chunk
    });

Parameters

Return value

// Establish an outgoing TCP connection, and close it again.
Network.socket("tcp")
    .connect("10.0.0.1", 80)
    .onconnect(function(socket) {
        socket.close();
    })
    .onclose(function(socket, error) {
        log("socket closed");
        if (error) log("error=" + error);
    });

Return value

Network.socket("tcp")
    .connect("10.0.0.1", 80)
    .onconnect(function(socket) {
        log("local " + socket.localAddress() + ":" + socket.localPort());
    });

Return value

Network.socket("tcp")
    .connect("10.0.0.1", 80)
    .onconnect(function(socket) {
        log("local " + socket.localAddress() + ":" + socket.localPort());
    });

Return value

// create a TCP server and close it right away
Network.server("tcp").close();

Parameters

Return value

// Create a TCP server and write the listen port to the log
Network.server("tcp")
    .onbind(function(socket, addr, port) {
        log("server bound to port TCP/" + port);
    });

Sets a callback function that is invoked on incoming connections. Optional.
The callback passes a Socket object to the application, that represents the incoming connection.

Usage:

• If no onsocket callback is set the server will reject all connections.
• If the onsocket callback is set you have to handle the connection using the socket object.
  • Call close on the socket object to reject the connection.
  • Use the socket object like a regular TCP or TLS socket in connecting state if you want to accept the connection.
    Set a onconnect callback on the socket, to get notified when the connection has been accepted.

Parameters

Return value

// TCP server that only accepts local connections
Network.server("tcp", "127.0.0.1", 1000)
    .onsocket(function(server, socket, addr, port) {
        if (addr != "127.0.0.1") socket.close();
        else handleConnection(socket);
    });

function handleConnection(socket) {
    // justs send "Bye!" and close again
    socket.onconnect(function(socket) {
        socket.send(Encoding.stringToBin("Bye!"));
    })
    .onsend(function(socket) {
        socket.close();
    });
}

Parameters

Return value

// Write something to the log if the server has been closed.
Network.server("tcp", null, 1000)
    .onsocket(function(server, socket, addr, port) {
        // handle incoming connections, e.g. reject
        socket.close();
    })
    .onclose(function(socket, error) {
        log("server closed");
        if (error) log("error=" + error);
    });

Return value

log("server bound to " + socket.localAddress() + ":" + socket.localPort());

Return value

log("server bound to " + socket.localAddress() + ":" + socket.localPort());

Parameters

Return value

// change the default certificate for TLS connections
Network.socketContext().setCertificate(null, customCertPemFile);

// LDAPS client socket using a separate context with a specific certificate
Network.socketContext("ldaps").setCertificate("client", ldapsCertPemFile);

Network.socket("tls", null, 0, false, "ldaps")
    .connect("10.0.0.1", 389)
    .onconnect(function(socket) {
        // do something with the connection
    });