Use an External Client App

In Salesforce, from Setup, enter Apps in the Quick Find box, then select App Manager.

Click New External Client App.

In the External Client App Name field, enter Hello World.

Accept the default API Name of Hello_World. This is the internal name of the canvas app and can’t be changed after you save it.

In the Contact Email field, enter your email address.

Select one of these options in the Distribution State field.

Local: Develop an external client app for your local org
Packaged: Develop an external client app for packaging and distribution

In the Logo Image URL field, enter https://localhost:8443/images/salesforce.png. This is the default Salesforce “No Software” image. This image appears on the installation screen and on the detail screen for the app.

In the Icon URL field, enter https://localhost:8443/examples/hello-world/logo.png. This is the default Salesforce “No Software” image.

This is the image that appears next to the app name in the user interface. If you leave this field blank, a default cloud image appears next to the app name.

In the API (Enable OAuth Settings) section, select Enable OAuth.

In the Callback URL field, enter https://localhost:8443/sdk/callback.html.

In the OAuth Scopes field, select Access the identity URL service (id, profile, email, address, phone) from the Available OAuth Scopes list and move it to the Selected OAuth Scopes list.

In the Canvas App Settings section, select Enable Canvas.

In the Canvas App URL field, enter https://localhost:8443/examples/hello-world/index.jsp.

In the Access Method field, select Signed Request (POST).

In the Locations field, select Lightning Component from the Available list and move it to the Selected list.

Click Create

After the canvas app is saved, the detail page appears.

In the Settings tab, expand the OAuth Settings section, and click Consumer Key and Secret. Then, verify your identity.

Select the consumer secret value and press Ctrl+c (Windows) to copy it. The consumer secret is used in the app to authenticate.

Go to the command window and stop the Jetty Web server by pressing Ctrl+c (Windows). At the prompt, enter Y.

Create an environment variable named CANVAS_CONSUMER_SECRET and set that value to the consumer secret you just copied. To do this in Windows, in the command window, enter set CANVAS_CONSUMER_SECRET=value_you_just_copied.

If you’re using Unix/OS X, set the environment variable with the command export CANVAS_CONSUMER_SECRET=value_you_just_copied.

The “hello world” page (c:\SalesforceCanvasFrameworkSDK\src\main\webapp\examples\hello-world\index.jsp) uses the consumer secret, as shown in the following code:

1<%@ page import="canvas.SignedRequest" %>
2<%@ page import="java.util.Map" %>
3<%
4    // Pull the signed request out of the request body and verify and decode it.
5    Map<String, String[]> parameters = request.getParameterMap();
6    String[] signedRequest = parameters.get("signed_request");
7    if (signedRequest == null) {%>
8        This app must be invoked via a signed request!<%
9        return;
10    }
11    String yourConsumerSecret=System.getenv("CANVAS_CONSUMER_SECRET");
12    String signedRequestJson = SignedRequest.verifyAndDecodeAsJson(signedRequest[0], yourConsumerSecret);
13%>
14
15<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
16<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
17<head>
18
19    <title>Hello World Canvas Example</title>
20
21    <link rel="stylesheet" type="text/css" href="/sdk/css/connect.css" />
22
23    <script type="text/javascript" src="/sdk/js/canvas-all.js"></script>
24
25    <!-- Third part libraries, substitute with your own -->
26    <script type="text/javascript" src="/scripts/json2.js"></script>
27
28    <script>
29        if (self === top) {
30            // Not in an iFrame.
31            alert("This canvas app must be included within an iFrame");
32        }
33
34        Sfdc.canvas(function() {
35            var sr = JSON.parse('<%=signedRequestJson%>');
36            Sfdc.canvas.byId('username').innerHTML = sr.context.user.fullName;
37        });
38
39    </script>
40</head>
41<body>
42    <br/>
43    <h1>Hello <span id='username'></span></h1>
44</body>
45</html>

Restart the Web server by entering this command: target\bin\webapp.bat (Windows) or sh target/bin/webapp (Unix/OS X).

Canvas Developer Guide

See Also