Force.com Canvas

Мы строили, строили и наконец построили :)

Что такое Force.com Canvas?
Force.com Canvas это технология, которая позволяет нам интегрировать сторонние приложения с нашим salesforce оргом.
Не важно на каком языке написано стороннее приложение, важно лишь доступность нашего приложения через https.

Force.com Canvas позволяет нам взаимодействовать с сторонним приложение от имени текущего salesfroce пользователя.

Компоненты Force.com Canvas.

SSL(TLS)/HMAC/SHA - для безопасного обмена данными между нашим приложением и SF оргом
Browser - с поддержкой cross domain javascript
JavaScript / IFRAME - при помощи которых наши приложение встраивается в SF
Salesforce APIs - REST / SOAP для обмена данными
Canvas SDK - javascript api от SF

Где можно разместить Force.com Canvas?

В зависимости от заданных настроек, наше приложение может быть доступно на:

Chatter page
VisualForce Page
Tab
Page Layout
Standalone

Если мы хотим встроить наше приложение на VF page, мы должны использовать тег <apex:canvasApp /> c fnnhb,enfvb

developerName - имя нашего canvas приложения
entityFields - список полей объекта, которые мы хотим передать в наше приложение (доступно с summer 14)
parameters - строка в JSON формате ({param1: “value”, param2:value})

Технологии используемые Force.com Canvas

Javascript SDK - позволяет взаимодействовать стороннему приложению с SF
Signed Request - данные отправляемые в наше приложение при помощи POST
1. Содержит контекстную информацию
  1. User info
  2. Org info
  3. Environment info
  4. Authentication info
2. JSON формат

Signed Request

Signed Request - параметр который передается в POST запросе в наше стороннее приложение. Это обычная строка, которую можно вытянуть из запроса следующим образом

var srEncoded = Request.Params.Get("signed_request");

Данная строка выглядит как base64 encoded и состоит из двух частей разделунных точкой.

левая_часть.правая_часть

Левая часть представляет собой электронную подпись, которую формирует SF и которую мы должны будем получить на .net стороне.

Правая часть это и есть наши параметры, которые передает SF в формате JSON.

От теории к практике!

Создать Canvas app очень просто. Он создается как и обычный connected app(Setup->Create->Apps->Connected apps), но для правильной работы нужно выполнить следующие шаги:

1. Выставить чекбокс Enable OAuth Settings в true, прописать callback url (совершенно любой урл в нашем случае) и выбрать scope для нашего приложения.

2. Далее опускаемся ниже (:p) и выставляем Force.com Canvas. Указываем Canvas App Url(по данному урлу и будут происходить взаимодействия между SF и .Net строной). Указываем Access Method как Signed Request и выбираем Locations(место где будет доступен наш canvas app)

После нажатия на Save будет создан Canvas App.

Стоит отметить, для того чтобы ограничить доступ к нашей .net стороне нам стоит запомнить Consumer Secret( с помощью него мы бедем генерировать и проверядь электронные подписи).

На этом настройка приложение на SF в принципе закончена.

.Net сторона

Я не совсем уверен что стоит подробно описывать все манипуляции, которые нужно провернуть .net части. Поэтому просто оставлю это здесь.(VS2013 solution)