釘釘isv免登錄

muddyway 發(fā)布于2019-06-27 14:44 / 2027人閱讀

摘要：而我現(xiàn)在要說(shuō)的是接入中的必要條件，免登錄。第一步注冊(cè)釘釘企業(yè)賬號(hào)。當(dāng)所有的工作完成以后我們可以用這個(gè)釘釘賬號(hào)，登陸釘釘，找到你的測(cè)試企業(yè)，在測(cè)試企業(yè)的應(yīng)用中就會(huì)有你創(chuàng)建的應(yīng)用。需要注意的是回調(diào)地址必須有效套件必須激活相關(guān)文檔釘釘開(kāi)發(fā)官網(wǎng)地址

釘作為團(tuán)隊(duì)內(nèi)部人員的通訊軟件被原來(lái)越多的企業(yè)所應(yīng)用，同時(shí)釘釘支持接入第三方應(yīng)用和企業(yè)內(nèi)部個(gè)人應(yīng)用，即isv接入和企業(yè)接入。而我現(xiàn)在要說(shuō)的是isv接入中的必要條件，isv免登錄。
準(zhǔn)備工作
釘釘有詳細(xì)的開(kāi)發(fā)文檔，這個(gè)是開(kāi)發(fā)文檔的鏈接地址，其中有一個(gè)isv的接入指南，這上面介紹了isv是如何接入。
第一步：注冊(cè)釘釘企業(yè)賬號(hào)。在這里可以看到
第二步：成為釘釘開(kāi)發(fā)者，鏈接地址
第三步：是開(kāi)發(fā)套件。
首先我們需要?jiǎng)?chuàng)建套件

點(diǎn)擊套件的創(chuàng)建，會(huì)出現(xiàn)下面的畫面

這些在開(kāi)發(fā)文檔上面都有介紹。在這個(gè)畫面中主要是回調(diào)url。釘釘為php開(kāi)發(fā)者寫了一個(gè)關(guān)于php的demo,demo地址，這個(gè)里面有一個(gè)config.php，里面的參數(shù)是需要我們進(jìn)行填寫


在我們還沒(méi)有獲取到SUITE_KEY、SUITE_SECRET時(shí)默認(rèn)的是空值，token、ENCODING_AES_KEY都是創(chuàng)建套件的時(shí)候填寫的。APPID是應(yīng)用的id，現(xiàn)在先為空。
回調(diào)的方法是receive.php。回調(diào)url可以寫成http://域名/地址/receive.php
填寫完成以后我們需要驗(yàn)證url的有效性，驗(yàn)證成功以后，點(diǎn)擊確定。
我們會(huì)在套件基本信息中獲取到SUITE_KEY、SUITE_SECRET，我們需要將值填寫到config.php中。
然后需要?jiǎng)?chuàng)建應(yīng)用

主頁(yè)的地址就是我們點(diǎn)擊應(yīng)用進(jìn)入的地址。
創(chuàng)建完應(yīng)用以后，APPID即可寫上應(yīng)用的id。
注冊(cè)測(cè)試企業(yè)


管理員賬號(hào)可以寫已經(jīng)注冊(cè)的釘釘?shù)氖謾C(jī)號(hào)碼，如果這里隨便寫個(gè)賬號(hào)的話，注冊(cè)完成以后需要綁定你已經(jīng)注冊(cè)的釘釘賬號(hào)。當(dāng)所有的工作完成以后我們可以用這個(gè)釘釘賬號(hào)，登陸釘釘app，找到你的測(cè)試企業(yè)，在測(cè)試企業(yè)的應(yīng)用中就會(huì)有你創(chuàng)建的應(yīng)用。
創(chuàng)建完成測(cè)試企業(yè)以后，我們需要對(duì)測(cè)試企業(yè)進(jìn)行授權(quán)。

當(dāng)點(diǎn)擊授權(quán)以后，釘釘會(huì)向我們寫的回調(diào)url,即receive.php推送`/**
 * 臨時(shí)授權(quán)碼
 */
else if ("tmp_auth_code" === $eventType)
{
    $tmpAuthCode = $eventMsg->AuthCode;
    Activate::autoActivateSuite($tmpAuthCode);
}`
我們可以在方法中看到執(zhí)行這段代碼，這段代碼主要是獲取到臨時(shí)授權(quán)碼，然后`
require_once(__DIR__ . "/../util/Log.php");
require_once(__DIR__ . "/../util/Http.php");
require_once(__DIR__ . "/ISVService.php");
/**
激活I(lǐng)SV套件方法類
*/

class Activate
{
/**
 * 某個(gè)企業(yè)的臨時(shí)授權(quán)碼在成功換取永久授權(quán)碼后，開(kāi)放平臺(tái)將不再推送該企業(yè)臨時(shí)授權(quán)碼。
 */
public static function autoActivateSuite($tmpAuthCode)
{
    //持久化臨時(shí)授權(quán)碼
    //Cache::setTmpAuthCode($tmpAuthCode);
    $suiteTicket = Cache::getSuiteTicket();
    $suiteAccessToken = ISVService::getSuiteAccessToken($suiteTicket);
    Log::i("[Activate] getSuiteToken: " . $suiteAccessToken);
    //獲取永久授權(quán)碼以及corpid等信息，持久化，并激活臨時(shí)授權(quán)碼
    $permanetCodeInfo = ISVService::getPermanentCodeInfo($suiteAccessToken, $tmpAuthCode);
    Log::i("[Activate] getPermanentCodeInfo: " . json_encode($permanetCodeInfo));
    
    $permanetCode = $permanetCodeInfo["permanent_code"];
    $authCorpId = $permanetCodeInfo["corp_id"];
    Log::i("[Activate] permanetCode: " . $permanetCode . ",  authCorpId: " . $authCorpId);
    
    /**
     * 獲取企業(yè)access token
     */
    $corpAccessToken = ISVService::getIsvCorpAccessToken($suiteAccessToken, $authCorpId, $permanetCode);
    Log::i("[Activate] getCorpToken: " . $corpAccessToken);
    
    /**
     * 獲取企業(yè)授權(quán)信息
     */
    $res = ISVService::getAuthInfo($suiteAccessToken, $authCorpId, $permanetCode);
    Log::i("[Activate] getAuthInfo: " . json_encode($res));
    self::check($res);
    /**
     * 激活套件
     */
    $res = ISVService::activeSuite($suiteAccessToken, $authCorpId, $permanetCode);
    Log::i("[activeSuite]: " . json_encode($res));
    self::check($res);
}


static function check($res)
{
    if ($res->errcode != 0)
    {
        exit("Failed: " . json_encode($res));
    }
}
}`
這段代碼執(zhí)行完成以后主要是激活套件，只有激活套件以后，我們才可以在測(cè)試企業(yè)的應(yīng)用中看到我們創(chuàng)建的應(yīng)用。否則無(wú)法看到應(yīng)用。
應(yīng)用的客戶端頁(yè)面，即在手機(jī)端看到的首頁(yè)
在demo中我們會(huì)看到一個(gè)index.php和一個(gè)indexpc.php,一個(gè)是手機(jī)端的首頁(yè)一個(gè)是pc端的首頁(yè)。index.php的代碼是：`
require_once(__DIR__ . "/config.php");
require_once(__DIR__ . "/util/Http.php");
require_once(__DIR__ . "/api/Auth.php");
$corpId =  $_GET["corpid"];
?>


jsapi demo













`
在這個(gè)里面我們可以看到一個(gè)corpid的參數(shù)，這個(gè)是企業(yè)的id，目前是我們的測(cè)試企業(yè)的id，這個(gè)參數(shù)可以在我們創(chuàng)建的測(cè)試企業(yè)的管理頁(yè)面看到。在執(zhí)行的receive.php中，我們可以看到有一個(gè)日志，一個(gè)是isv.log，在這個(gè)里面也可以獲取到corpid。而在index.php中這個(gè)是變量，所以我們?cè)趧?chuàng)建應(yīng)用時(shí)的主頁(yè)地址，可以增加corpid這個(gè)參數(shù)，即index.php?corpid=。
當(dāng)所有的配置都弄成功以后，我們可以得手機(jī)端點(diǎn)擊應(yīng)用獲取到userid。即免登錄成功。
需要注意的是
回調(diào)地址必須有效
套件必須激活
相關(guān)文檔：
釘釘開(kāi)發(fā)官網(wǎng)地址