用Delphi调用阿里云的OpenAPI更新动态域名解析记录

2024-01-06 11:04

本文主要是介绍用Delphi调用阿里云的OpenAPI更新动态域名解析记录,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

用Delphi调用阿里云的OpenAPI更新动态域名解析记录

       家里一直是电信的宽带,虽然只是200M下行30M上行的平均水平,但是对于平时下载量不大的我来说已经绰绰有余了,很多时候需要从外网访问家里的NAS的资料,但是因为不是固定IP,每次一重启路由器或者每隔几天,家里的IP地址都是变动一下,前阵子一直使用docker安装了一个阿里云的DDNS软件非常好用,突然有一天不更新IP到阿里云的服务器上了,又加上自己的管理软件的服务端是安装到Windows下(用unRaidNAS虚拟了一个WindowsServer),所以干脆想办法把这个功能加到自己的管理服务端软件上,这时候开始祭出我们的工具Delphi。(前几篇文章已经说了如何安装社区版的Delphi和如何在unRaid下虚拟Windows)。

       在正式操作之前,首先说明下使用aliyun的DDNS的基本条件。  

      1、这个也是最最关键的必不可少的一步,就是你家必须要有公网IP,现在很多地方宽带供应商只给内网IP(特别是移动和联通),如果是电信的话,可以打10000号免费开通公网IP功能,至于给不给你开,看各地的政策。反正我家一直是公网IP。

      2、你得有个阿里云的域名,如果没有,赶紧去阿里云上去买个,不差钱的可以买个.com、.cn的,如果只是玩玩的可以买个.xyz等超级便宜的域名。至于腾讯云的域名,有两种方法:你可以把域名改为阿里云托管,也可以将下面的代码稍微改动改成腾讯云的。因为我只有阿里云的域名,所以没法测试腾讯云的,这里就不改动了

      3、获得阿里云的访问key和访问key的密钥。这个在你登录阿里云后,在头像上点击鼠标左键会弹出来一个菜单,就可以直接看到。这里也给个建议,最好不要用主key和密钥,因为一旦泄露,也就是将你的阿里云的所有权限暴露给别人了,所以可以建立一个子用户key并且给他设置权限只能修改域名解析。

      4、提前在阿里云的域名管理上建立一个新的二级域名,虽然可以通过代码添加,但是我觉得自己手工添加会更安全,至少不会让自己的域名列表不经意的多出很多无用的二级域名。

       有了前面的几步,现在正是进入主题。代码写起来比较简单,只要根据阿里云的OpenAPI的文档编写就可以,当然你得学会看懂文档。很快我就将所有的代码完成,但是运行的时候一直提示错误,最主要错误就是一直提示签名值错误,这个签名值在我的理解也就是校验值,用来校验你是否有权限访问和修改域名解析。然后慢慢调试,在查看文档和阿里云公开的代码,发现有几个大坑,而在文档上却没有说明,当然也可能和每个编程工具的处理有点小关系,现在将每个大坑一一的说明下:

       坑1:做签名值的时候,发现调试出来的签名值很长,几乎是官方计算出来的两到三倍,代码仔细看看没什么打问题,已经按照文档要求使用了URL编码后再进行HMAC_SHA1然后最后再进行BASE64编码,整个过程都没任何问题,而且编码函数经过测试也没问题。文档上也没有任何说明要做其他的编码或者转变。后来发现惊醒HMAC_SHA1编码的时候,一定要生成他的原始二进制数据,而我们正常情况下一般都是生成字符串数据,我了了个去!好了,现在生成的签名值已经和官方的签名值的长度一模一样。

Pascal

varsSignByte: TBytes;
begin// 构造用于签名的字符串Result := Format('GET&%s&%s', [TURI.URLEncode('/'), TURI.URLEncode(sCanonicalQueryString)]);// 使用HMAC-SHA1计算返回原始二进制数据sSignByte := THashSHA1.GetHMACAsBytes(Result, sKeyScret + '&');// 得到签名值Result := TURI.URLEncode(TNetEncoding.Base64.EncodeBytesToString(sSignByte));
end;

       坑2:这下自以为没问题了,但是生成的签名值一直没官方的不一样啊,编码前的原始字符串貌似也一模一样,就是生成的签名值确实另外一个值,无奈,只能又是一步一步调试并且每一步和官方的值做对比,突然发现,UTC时间经过URL编码后会把里面的时间分隔符的":"会编码上"%3A",在生成签名值前,再进行一次URL编码,官方的会把签名的“%3A”里面的"%"再进行一次编码,变成了"%253A",而在Delphi中却没有编码,在我的理解中,确实不需要再编码了啊,因为这里已经按URL编码过一次了,这也算是一个坑吧,没办法,只能按照阿里云的要求,对其中的%再进行一次单独的替换。所以就有了下面代码的最后2行代码。

Pascal

  sBody := Format('AccessKeyId=%s&Action=DescribeSubDomainRecords&Format=json&SignatureMethod=HMAC-SHA1&', [sKey.Trim]);sBody := sBody + Format('SignatureNonce=%s&SignatureVersion=1.0&SubDomain=%s&', [GetNowStr, LowerCase(sDomain.Trim)]);sBody1 := sBody + Format('Timestamp=%s&Version=2015-01-09', [GetUTC]);sBody := sBody + Format('Timestamp=%s&Version=2015-01-09', [GetUTC.Replace('%', '%25')]);

       坑3:获取UTC时间,UTC时间也就是我们说的世界标准时间,正常我们获取UTC时间都是带毫秒的,这个一点问题都没有,而且也都是ISO8601的标准对时间进行格式化,但是我发现,在生成签名值的时候,和官方算出来的虽然一模一样,但是每次还是提示签名值不对,这个坑整整耗了我一天时间,百思不得其解。后来仔细对比,官方获取的UTC时间只精确到秒,而我获取的UTC时间是精确到毫秒,理论上这个没太大的关系,但是我尝试和官方同步使用精确到秒之后,这个问题竟然给解决了。

Pascal

function GetUTC: string;
// 获取ISO8601格式的UTC世界标准时间
varpTime: _TIME_ZONE_INFORMATION;
beginGetTimeZoneInformation(pTime);// 自带的函数带有毫秒,在Update的时候签名值出错,所以使用不带毫秒的时间// Result := TURI.URLEncode(DateToISO8601(IncMinute(Now, pTime.bias)));Result := TURI.URLEncode(FormatDateTime('YYYY-MM-DD''T''hh:nn:ss''Z''', IncMinute(Now, pTime.bias)));
end

       经过上面的填坑,很快整个代码都修改完成,其他的代码都是最最常规的,经过测试,已经很轻松的能够更新阿里云的域名解析了。加到自己的软件服务端,再也不需要安装官方或者其他的AliDDNS软件了。下面将所有的代码贴上,拿走不谢,如果有看官发现里面的错误或者有新的改动,希望能给个反馈哦。

Pascal

// *******************************************************
//
// AliDDNS - 阿里云DDNS自动更新代码
//
// 版权所有 (C) 2019-2020
// 作者:      HenryXu
// 更新日期:  2020.03.23
// 联系方式:QQ( 55524082 )
// 说明:
// 01、本函数只适用于AliYun的动态域名更新解析使用
// 02、域名必须在AliYun上注册
// 03、AliYun的AccessKeyID和AccessKeySecret可控制AliYun的所有权限,请妥善保管
// 04、建议开通子用户AccessKey,并设置只能修改云解析的权限
// 05、本函数待有优化之处,我会及时更新
// 06、有什么建议或修改其中的代码,希望能发一份给我以共同修改
//
// *******************************************************unit SQ_AliDDNS;interfaceusesWinapi.Windows, System.Classes, System.SysUtils, System.JSON, System.DateUtils, System.Hash, System.NetEncoding,System.Net.URLClient, System.Net.HttpClient, System.Net.HttpClientComponent, System.Net.Socket;{ -------------------------------------------------------------------------------过程名:    UpdateDomainRecord作者:      HenryXu日期:      2020.03.21参数:      sKey, sKeyScret, sDomain: string参数说明: AccessKeyID,AccessKeySecret,域名返回值:    string------------------------------------------------------------------------------- }
function UpdateDomainRecord(sKey, sKeyScret, sDomain: string): string;implementationconstApiAliAddr = 'http://alidns.aliyuncs.com/';PubIPAddr = 'http://ip.3322.net/';typeTSubDomainInfo = recordRR: string;TTL: string;IP: string;RecordId: string;Output: string;end;function GetUTC: string;
// 获取ISO8601格式的UTC世界标准时间
varpTime: _TIME_ZONE_INFORMATION;
beginGetTimeZoneInformation(pTime);// 自带的函数带有毫秒,在Update的时候签名值出错,所以使用不带毫秒的时间// Result := TURI.URLEncode(DateToISO8601(IncMinute(Now, pTime.bias)));Result := TURI.URLEncode(FormatDateTime('YYYY-MM-DD''T''hh:nn:ss''Z''', IncMinute(Now, pTime.bias)));
end;function GetNowStr: string;
beginResult := FormatDateTime('YYYYMMDDhhnnss', Now);
end;function httpSendRequest(sBody: string): string;
// 发送Http请求
varFHttpClient: TNetHttpClient;
beginFHttpClient := TNetHttpClient.Create(nil);tryResult := FHttpClient.Get(sBody).ContentAsString(TEncoding.UTF8);finallyFHttpClient.Free;end;
end;function GetPublicIP: string;
// 获取本机的公网IP
beginResult := httpSendRequest(PubIPAddr).Trim;
end;function GetSignature(sCanonicalQueryString, sKeyScret: string): string;
varsSignByte: TBytes;
begin// 构造用于签名的字符串Result := Format('GET&%s&%s', [TURI.URLEncode('/'), TURI.URLEncode(sCanonicalQueryString)]);// 使用HMAC-SHA1计算返回原始二进制数据sSignByte := THashSHA1.GetHMACAsBytes(Result, sKeyScret + '&');// 得到签名值Result := TURI.URLEncode(TNetEncoding.Base64.EncodeBytesToString(sSignByte));
end;function GetDomainRecordID(sKey, sKeyScret, sDomain: string): TSubDomainInfo;
// 获取AliYun上对应域名的解析信息
varsBody, sBody1: string;oJson: TJSONObject;index: integer;
beginsBody := Format('AccessKeyId=%s&Action=DescribeSubDomainRecords&Format=json&SignatureMethod=HMAC-SHA1&', [sKey.Trim]);sBody := sBody + Format('SignatureNonce=%s&SignatureVersion=1.0&SubDomain=%s&', [GetNowStr, LowerCase(sDomain.Trim)]);sBody1 := sBody + Format('Timestamp=%s&Version=2015-01-09', [GetUTC]);sBody := sBody + Format('Timestamp=%s&Version=2015-01-09', [GetUTC.Replace('%', '%25')]);Result.Output := httpSendRequest(Format('%s?%s&Signature=%s', [ApiAliAddr, sBody1,GetSignature(sBody, sKeyScret.Trim)]));// 这里从结果中需要取RecordId,RR和TTL三个值oJson := TJSONObject.ParseJSONValue(Trim(Result.Output)) as TJSONObject;if oJson <> nil thenbegintryif oJson.TryGetValue('TotalCount', index) and (index > 0) thenbeginResult.RecordId := oJson.GetValue<String>('DomainRecords.Record[0].RecordId').Trim;Result.RR := oJson.GetValue<String>('DomainRecords.Record[0].RR').Trim;Result.IP := oJson.GetValue<String>('DomainRecords.Record[0].Value').Trim;Result.TTL := oJson.GetValue<String>('DomainRecords.Record[0].TTL').Trim;end;finallyoJson.Free;end;end;
end;function UpdateDomainRecord(sKey, sKeyScret, sDomain: string): string;
// 更新AliYun上对应域名的IP记录
varsBody, sBody1: string;SubdomainInfo: TSubDomainInfo;
beginif GetPublicIP = TIPAddress.LookupName(sDomain).Address thenExit;SubdomainInfo := GetDomainRecordID(sKey, sKeyScret, sDomain);if not SubdomainInfo.RecordId.IsEmpty then// 如果AliYun中存在对应域名的记录begin// 以防万一再次确认公网IP和域名记录里的IP是否一样if GetPublicIP = SubdomainInfo.IP thenExit;sBody := Format('AccessKeyId=%s&Action=UpdateDomainRecord&Format=json&RR=%s&', [sKey.Trim, SubdomainInfo.RR]);sBody := sBody + Format('RecordId=%s&SignatureMethod=HMAC-SHA1&', [SubdomainInfo.RecordId]);sBody := sBody + Format('SignatureNonce=%s&SignatureVersion=1.0&TTL=%s&', [GetNowStr, SubdomainInfo.TTL]);sBody1 := sBody + Format('Timestamp=%s&Type=A&Value=%s&Version=2015-01-09', [GetUTC, GetPublicIP]);sBody := sBody + Format('Timestamp=%s&Type=A&Value=%s&Version=2015-01-09',[GetUTC.Replace('%', '%25'), GetPublicIP]);Result := httpSendRequest(Format('%s?%s&Signature=%s', [ApiAliAddr, sBody1, GetSignature(sBody, sKeyScret.Trim)]));endelseResult := SubdomainInfo.Output;
end;end.

 

这篇关于用Delphi调用阿里云的OpenAPI更新动态域名解析记录的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/576145

相关文章

第10章 中断和动态时钟显示

第10章 中断和动态时钟显示 从本章开始,按照书籍的划分,第10章开始就进入保护模式(Protected Mode)部分了,感觉从这里开始难度突然就增加了。 书中介绍了为什么有中断(Interrupt)的设计,中断的几种方式:外部硬件中断、内部中断和软中断。通过中断做了一个会走的时钟和屏幕上输入字符的程序。 我自己理解中断的一些作用: 为了更好的利用处理器的性能。协同快速和慢速设备一起工作

poj3468(线段树成段更新模板题)

题意:包括两个操作:1、将[a.b]上的数字加上v;2、查询区间[a,b]上的和 下面的介绍是下解题思路: 首先介绍  lazy-tag思想:用一个变量记录每一个线段树节点的变化值,当这部分线段的一致性被破坏我们就将这个变化值传递给子区间,大大增加了线段树的效率。 比如现在需要对[a,b]区间值进行加c操作,那么就从根节点[1,n]开始调用update函数进行操作,如果刚好执行到一个子节点,

hdu1394(线段树点更新的应用)

题意:求一个序列经过一定的操作得到的序列的最小逆序数 这题会用到逆序数的一个性质,在0到n-1这些数字组成的乱序排列,将第一个数字A移到最后一位,得到的逆序数为res-a+(n-a-1) 知道上面的知识点后,可以用暴力来解 代码如下: #include<iostream>#include<algorithm>#include<cstring>#include<stack>#in

hdu1689(线段树成段更新)

两种操作:1、set区间[a,b]上数字为v;2、查询[ 1 , n ]上的sum 代码如下: #include<iostream>#include<algorithm>#include<cstring>#include<stack>#include<queue>#include<set>#include<map>#include<stdio.h>#include<stdl

阿里开源语音识别SenseVoiceWindows环境部署

SenseVoice介绍 SenseVoice 专注于高精度多语言语音识别、情感辨识和音频事件检测多语言识别: 采用超过 40 万小时数据训练,支持超过 50 种语言,识别效果上优于 Whisper 模型。富文本识别:具备优秀的情感识别,能够在测试数据上达到和超过目前最佳情感识别模型的效果。支持声音事件检测能力,支持音乐、掌声、笑声、哭声、咳嗽、喷嚏等多种常见人机交互事件进行检测。高效推

动态规划---打家劫舍

题目: 你是一个专业的小偷,计划偷窃沿街的房屋。每间房内都藏有一定的现金,影响你偷窃的唯一制约因素就是相邻的房屋装有相互连通的防盗系统,如果两间相邻的房屋在同一晚上被小偷闯入,系统会自动报警。 给定一个代表每个房屋存放金额的非负整数数组,计算你 不触动警报装置的情况下 ,一夜之内能够偷窃到的最高金额。 思路: 动态规划五部曲: 1.确定dp数组及含义 dp数组是一维数组,dp[i]代表

如何在页面调用utility bar并传递参数至lwc组件

1.在app的utility item中添加lwc组件: 2.调用utility bar api的方式有两种: 方法一,通过lwc调用: import {LightningElement,api ,wire } from 'lwc';import { publish, MessageContext } from 'lightning/messageService';import Ca

hdu 1754 I Hate It(线段树,单点更新,区间最值)

题意是求一个线段中的最大数。 线段树的模板题,试用了一下交大的模板。效率有点略低。 代码: #include <stdio.h>#include <string.h>#define TREE_SIZE (1 << (20))//const int TREE_SIZE = 200000 + 10;int max(int a, int b){return a > b ? a :

AI行业应用(不定期更新)

ChatPDF 可以让你上传一个 PDF 文件,然后针对这个 PDF 进行小结和提问。你可以把各种各样你要研究的分析报告交给它,快速获取到想要知道的信息。https://www.chatpdf.com/

GIS图形库更新2024.8.4-9.9

更多精彩内容请访问 dt.sim3d.cn ,关注公众号【sky的数孪技术】,技术交流、源码下载请添加微信:digital_twin123 Cesium 本期发布了1.121 版本。重大新闻,Cesium被Bentley收购。 ✨ 功能和改进 默认启用 MSAA,采样 4 次。若要关闭 MSAA,则可以设置scene.msaaSamples = 1。但是通过比较,发现并没有多大改善。