聊城做网站的公司价位,网站修改title,中国机械加工网哪家好,长沙口碑最好的装修公司排名在上一篇文章中#xff0c;我们一步步从无到有在Microsoft Teams中开发了一个简单的Outgoing Webhook#xff0c;并和我们本地的Web API应用程序产生交互#xff0c;总结起来的步骤大概如下#xff1a;
导航到“团队” Tab页#xff0c; 选中需要建立的Channel, 选中“应…在上一篇文章中我们一步步从无到有在Microsoft Teams中开发了一个简单的Outgoing Webhook并和我们本地的Web API应用程序产生交互总结起来的步骤大概如下
导航到“团队” Tab页 选中需要建立的Channel, 选中“应用”这个Tab点击最下方的“创建传出webhook”开发传出webhook的后端服务配置ngrok进行请求转发Team中发送消息后端程序响应消息
这篇文章我们一起来看看如何使用dotnet的模板来快速开发一个带安全验证机制的Outgoing Webhook
1. 运行ngrok记下转发的地址 2. 在teams里新建一个app这次记下security token
具体的创建步骤见第一篇文章 3. 安装dotnet的模板
因为Teams的模板默认没有安装所以我们需要在dotnet里添加模板
c:\demo dotnet new -i MicrosoftTeams.Templates4. 使用模板创建Teams Outgoing Webhook项目
运行以下命令来在当前目录下创建工程
c:\demo dotnet new teamswebhook使用VS code打开这个目录找到appsettings.cs文件修改配置节点TeamsAppSecurityToken 填入我们创建Webhook时生成的security token
{Logging: {LogLevel: {Default: Warning}},AllowedHosts: *,TeamsAppSecurityToken: aDpHmzChz9r57niKFCew1AeI6tGjway5TfACZC7L88
}5. 运行程序
c:\demo dotnet run返回到Teams的对话框中我们发送一条消息观察Teams的消息返回 注意到消息正常返回且提示我们尝试输入hero 或者 thumbnail那我们根据提示分别发送hero和thumbnail 上面的整个过程就是我们基于Microsoft Teams的模板创建的整个可交互的Outgoing Webhook的应用下面我们来分析下整个的代码结构 首先看到Services中定义的接口ITeamsAuthProvider.cs
public interface ITeamsAuthProvider
{/// summary/// Validates the specified authentication header value./// /summary/// param namerequestThe HTTP request message./param/// returns/// Response containing result of validation./// /returnsTeamsAuthResponse Validate(HttpRequest request);
}其中的Validate方法用于对请求的授权认证TeamsAuthProvider.cs继承ITeamsAuthProvider实现了Validate 的认证授权逻辑。这个验证用来确保这个请求是从微软Teams的服务器发过来的而不是其他恶意的程序发送的请求从而确保的请求的发起源是受信任的。
接着看下MessagesController中,GetMessage这个Action首先实现对请求授权的判断
var authResult _teamsAuth.Validate(this.Request);
if (!authResult.AuthSuccessful)
{return new Activity(){Text You are not authorized to call into this end point.};
}重点我们看下下面这段代码
Attachment attachment null;
if (activity.Text.Contains(hero, StringComparison.InvariantCultureIgnoreCase))
{var card CreateSampleHeroCard();attachment new Attachment(){ContentType HeroCard.ContentType,Content card};
}
else if (activity.Text.Contains(thumbnail, StringComparison.InvariantCultureIgnoreCase))
{var card CreateSampleThumbnailCard();attachment new Attachment(){ContentType ThumbnailCard.ContentType,Content card};
}从上面的代码中看到我们在Teams中发送hero或者thumbnail时会看到响应的消息是一个带有图片的消息回复具体的这种图片消息 我们可以简单理解为是一种图片附件的形式我们来分析其中hero图片附件的代码
private HeroCard CreateSampleHeroCard()
{return new HeroCard(){Title Superhero,Subtitle An incredible hero,Text Microsoft Teams,Images new ListCardImage(){new CardImage(){Url https://github.com/tony-xia/microsoft-teams-templates/raw/master/images/cbd_after_sunset.jpg}},Buttons new ListCardAction(){new CardAction(){Type openUrl,Title Visit,Value http://www.microsoft.com}}};
}可以比较清楚的看到一些标题Title和显示问题Text, 其中Image作为显示图片URL, 这里的Buttons是这一种行为当我们点击时跳转到对应设置的网站点击可以看到跳转到微软的官网。
可以看到使用dotnet template来创建outgooing webhook项目方便快速而且使用了card使得返回的消息格式非常丰富。
