Skip to content

Latest commit

 

History

History
151 lines (123 loc) · 5.92 KB

README.md

File metadata and controls

151 lines (123 loc) · 5.92 KB
Raw

WCF.JS

A WCF-compatible web service client stack for node.js. Written in pure javascript!

Imagine this:

    var binding = new WSHttpBinding(
          { MessageEncoding: "Mtom"
          , SecurityMode:"TransportWithMessageCredential"
          })
      , proxy = new Proxy(binding)

    proxy.ClientCredentials.Username.Username = "yaron";
    proxy.ClientCredentials.Username.Password = "1234";

    proxy.send(message, function(response) {
      console.log(response)
    });

(See below for a complete working sample)

Currently supports a subset of:

  • BasicHttpBinding
  • WSHttpBinding
  • CustomBinding

The current subset includes:

  • MTOM / Text encodings
  • WS-Addressing (all versions)
  • Transport Security (SSL)
  • TransportWithMessageCredential (Username)
  • Message security where ClientCredentialType is Certificate (signature only, without encryption)

For more information visit my wcf blog or my twitter.

Install

Install with npm:

npm install wcf.js

Usage

BasicHttpBinding (TransportWithMessageCredential)

    var BasicHttpBinding = require('wcf.js').BasicHttpBinding
      , Proxy = require('wcf.js').Proxy
      , binding = new BasicHttpBinding(
            { SecurityMode: "TransportWithMessageCredential"
            , MessageClientCredentialType: "UserName"
            })
      , proxy = new Proxy(binding, "http://localhost:7171/Service/clearUsername")
      , message =  "<Envelope xmlns='http://schemas.xmlsoap.org/soap/envelope/'>" +
                     "<Header />" +
                       "<Body>" +
                         "<GetData xmlns='http://tempuri.org/'>" +
                           "<value>123</value>" +
                         "</GetData>" +
                        "</Body>" +
                   "</Envelope>"

    proxy.ClientCredentials.Username.Username = "yaron"
    proxy.ClientCredentials.Username.Password = "1234"

    proxy.send(message, "http://tempuri.org/IService/GetData", function(response, ctx) {
      console.log(response)
    });

CustomBinding (Mtom + UserNameOverTransport + WSAddressing10)

    var CustomBinding = require('wcf.js').CustomBinding
      , MtomMessageEncodingBindingElement = require('wcf.js').MtomMessageEncodingBindingElement
      , HttpTransportBindingElement = require('wcf.js').HttpTransportBindingElement
      , SecurityBindingElement = require('./lib/proxies/wcf.js').SecurityBindingElement
      , Proxy = require('wcf.js').Proxy
      , fs = require('fs')
      , binding = new CustomBinding(
            [ new SecurityBindingElement({AuthenticationMode: "UserNameOverTransport"})
            , new MtomMessageEncodingBindingElement({MessageVersion: "Soap12WSAddressing10"}),
            , new HttpTransportBindingElement()
            ])
      , proxy = new Proxy(binding, "http://localhost:7171/Service/mtom")
      , message = '<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">' +
                    '<s:Header />' +
                      '<s:Body>' +
                        '<EchoFiles xmlns="http://tempuri.org/">' +
                          '<value xmlns:a="http://schemas.datacontract.org/2004/07/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">' +
                            '<a:File1 />' +
                            '<a:File2 />' +
                          '</value>' +
                        '</EchoFiles>' +
                      '</s:Body>' +
                  '</s:Envelope>'  

    proxy.addAttachment("//*[local-name(.)='File1']", "me.jpg");
    proxy.addAttachment("//*[local-name(.)='File2']", "stuff.txt");

    proxy.ClientCredentials.Username.Username = "yaron";
    proxy.ClientCredentials.Username.Password = "1234";

    proxy.send(message, "http://tempuri.org/IService/EchoFiles", function(response, ctx) {
      console.log(response);
      //read an mtom attachment from the soap response
      var file = proxy.getAttachment("//*[local-name(.)='File1']")
      fs.writeFileSync("result.jpg", file)      
    });
``````````

### CustomBinding with message level signature
```````````````javascript
    var wcf = require('wcf.js')    
      , fs = require("fs")

    var sec = new wcf.SecurityBindingElement({ AuthenticationMode: "MutualCertificate"
      , ValidateResponseSignature: true})
      , binding = new wcf.CustomBinding(
      [ sec
      , new wcf.TextMessageEncodingBindingElement({MessageVersion: "Soap11WSAddressing10"})
      , new wcf.HttpTransportBindingElement()
      ])

    var proxy = new wcf.Proxy(binding, "http://localhost:7171/Service/sign_body_timestamp_wsa")
    proxy.ClientCredentials.ClientCertificate.Certificate = 
            fs.readFileSync("client.pem").toString()
    proxy.ClientCredentials.ServiceCertificate.DefaultCertificate = 
            fs.readFileSync("server_public.pem").toString()    

    var version = proxy.binding.getCustomBinding().getContentType() 
      , ns = version=="text/xml" ? 
        "http://schemas.xmlsoap.org/soap/envelope/" : 
        "http://www.w3.org/2003/05/soap-envelope"
      , message = "<Envelope xmlns='"+ns+"'>" +
                    "<Header />" +
                      "<Body>" +
                        "<GetData xmlns='http://tempuri.org/'>" +
                          "<value>123</value>" +
                        "</GetData>" +
                      "</Body>" +
                  "</Envelope>"

    proxy.send(message, "http://tempuri.org/IService/GetData", function(message, ctx) {
      console.log(ctx)
    })

Bitdeli Badge