前言

在多账号运营的场景当中，平台账号以及所属的登录手机号是属于企业的资产。日常登录时总是需要向账号所有者索要手机验证码，这大大降低了工作运营效率。
洋葱头提供了手机验证码自动转发功能，登录网站时无需经过其他人的协助。

1. 安装短信助手APP

账号所有者需要在手机上安装短信助手APP，APP会将接收到的短信验证码上报至服务器。
获取短信助手登录token： 操作步骤：
1、在 Android 手机上访问洋葱头官网下载页，安装短信助手 APP；
2、使用短信助手 token（即令牌）登录短信助手；
3、设置系统权限
需要根据APP提供的指引，设置系统权限，以保证APP可以正常获取手机短信。
登录APP并设置系统权限：
以上配置完成后，控制台的【手机号管理】页面中，可以看到安装了APP的设备信息，及设备上的手机号。

2. 配置短信转发规则与转发通道

2.1 页面入口

登录管理员账号访问洋葱头控制台。左侧导航中，进入 账号管理 > 手机短信 页面。

2.2 操作步骤

2.2.1 添加手机号

在上方步骤中成功登录短信助手并完成权限授权后，手机短信页面将自动出现支持转发短信的手机号。若没有，也可以通过右上方【添加手机号】手动添加。

适用场景： 在手机上安装短信助手 APP 以读取验证码

2.2.2 为手机号新增短信匹配规则

每个手机号下都可以配置一条或多条短信匹配规则。规则用于定义哪些短信需要被转发。

操作步骤： 在目标手机号下，点击“新建规则”，可根据下方字段说明进行配置。

字段	说明
规则名称	可选择复用已有规则或创建新的规则。 规则名称用于区分不同用途的规则，建议根据业务含义命名，例如：转发全部短信、在洋葱头登录巨量引擎、蝉妈妈等平台、向飞书群聊转发业务告警短信
匹配方式	1、全部短信：适用于需要转发该手机号收到的全部短信的场景。 2、按特征筛选：适用于仅转发特定短信的场景。 ①短信签名：必填，用于标识短信来源，可填写多个，用 ; 分隔。 ②短信关键词：选填，用于缩小匹配范围，可填写多个，用 ; 分隔。 规则效果：仅当短信命中已配置的签名和关键词条件时，系统才会执行转发。
转发通道	将短信转发至洋葱头或企业工作台。配置方式见下文

2.2.3 配置不同类型的转发通道

每条短信匹配规则都可以绑定一个或多个转发通道。短信一旦命中规则，即会同时转发到所有已配置的通道。

1. 洋葱头通道

洋葱头通道用于将命中的短信转发到洋葱头浏览器或洋葱头 APP。

字段	说明
通道名称	对通道的命名或备注
绑定应用	1、不指定应用： 如果不指定网站应用，则： ①用户在洋葱头浏览器的新标签页中不会看到该手机号账号； ②登录任意网站时，只要短信符合规则，系统都会转发短信内容。 2、指定应用： 如果指定网站应用，则： ①需要从控制台已有的网站应用列表中选择一个应用； ②用户可在洋葱头浏览器新标签页对应应用下看到该手机号账号。
选择应用	指定应用时出现，单选。应用列表来自控制台-网站平台。
授权成员	洋葱头通道支持配置授权成员。配置后，在洋葱头浏览器或洋葱头 APP 中，处于授权范围内的成员都可以接收该手机号转发的短信内容。 适用场景：团队共享验证码、多成员协作登录网站。

转发效果：
①在洋葱头浏览器PC端中接收验证码。 可点击浏览器右上角“手机短信”插件，打开后就能看到10分钟内收到的验证码，点击复制可一键获取验证码。 ②在洋葱头浏览器APP中接收验证码。 访问洋葱头官网，或者在手机应用商店搜索“贝锐洋葱头”即可安装APP。在APP中登录账号后，可在“短信”页面获取短信内容。

2. 飞书通道

飞书通道用于将短信通过机器人发送到飞书群聊。飞书机器人配置方式可见官方文档。

字段	说明
通道名称	对通道的命名或备注
Webhook URL	机器人通知地址，必填，从飞书中获取。
密钥	可选，用于飞书机器人开启签名校验时填写

下图为飞书机器人配置页 转发效果： 短信命中规则后，洋葱头会将短信转发给飞书机器人，实现在飞书群聊就可以收到短信内容。

3. 企微通道

企微通道用于将短信通过机器人发送到企业微信群聊。

字段	说明
通道名称	对通道的命名或备注
Webhook URL	机器人通知地址，必填，从企微群聊中获取

转发效果： 短信命中规则后，洋葱头会将短信转发给企业微信机器人，实现在企微群聊就可以收到短信内容。

4. 钉钉通道

钉钉通道用于将短信通过机器人发送到钉钉群聊。

字段	说明
通道名称	对通道的命名或备注
Webhook URL	机器人通知地址，必填，从钉钉群聊中获取。
加密密钥	可选，用于钉钉机器人开启安全校验时填写

转发效果： 短信命中规则后，洋葱头会将短信转发给钉钉机器人，实现在钉钉群聊就可以收到短信内容。

5. Webhook 通道

Webhook 通道适用于将短信内容推送到第三方平台或业务系统。

配置项说明

字段	说明
通道名称	对通道的命名或备注
Webhook URL	第三方平台的 webhook 地址，用来接收短信内容
请求方法	POST / GET / PUT / PATCH
请求头	格式：key 和 value，每行一组。如 Authorization: Bearer xxx

转发效果： 短信命中规则后，系统会按照所配置的请求方式和请求头，将短信内容推送到指定第三方接口。

适用场景： ①第三方平台接收短信 ②业务系统自动处理短信内容 ③与外部系统进行自动化对接

配置短信签名

配置短信签名以及关键词，APP将根据管理员设定的规则去读取验证码。

字段	说明
应用名称	关联网站应用中的应用名称，支持从已有应用列表中选择。
短信签名	在登录网站应用时，平台发送的短信验证码中会显示【签名】，将签名内容填入到控制台中。APP会根据设定的签名去转发符合条件的短信，见下图所示。
短信关键词	网站应用的短信发送场景中，通常包含了不同业务。管理员可以根据指定的关键词，如“验证码、注册码”，APP会根据设定的验证码来转发符合条件的短信，见下图所示。 若关键词为空，则符合短信签名的短信都会转发；若存在多个关键词，则只要短信命中其中一个关键词就会转发

短信内容中的签名和关键词：

平台账号授权

将手机号绑定到网站应用，并授权给指定的部门或成员。则成员在登录时可以自动拿到验证码。

字段	说明
账号名称	必填，对应用账号的命名，长度上限为50个字符
登录方式	必填。（1）账密登录。通过账号密码形式登录网站应用，需要填写账号密码（2）手机短信。通过手机验证码形式登录网站应用，需要选择手机号
手机号	必填，单选，从已有的手机号列表中选择
授权给下列应用	手机号需要关联的网站应用。关联后，在访问这个应用时，由该手机号收到的验证码可以自动转发给指定成员
备注	对应用账号的备注

添加应用账号后，可以按需将账号授权给指定部门或成员，则只有被授权的用户才能拿到登录时的手机验证码。