如何启用OCS WebServices中描述的OCS Inventory接口?有没有在PHP中使用此Web服务的示例代码?
OCS接口默认是禁用的,在使用之前必须打开它。OCS有一个用Perl开发的核心代码,它运行在Apache HTTP上。
首先,编辑文件/etc/apache2/conf-enabled/z-ocsinventory-server.conf
,将OCS_OPT_WEB_SERVICE_ENABLED
的选项值更改为1。如果没有启用web服务,您应该得到401 Forbidden响应。这是一个SOAP WebService,没有WSDL来描述功能,只有OCS WS文档中可用的文档。
检查/ocsinterface的位置标签是否类似以下片段:
<Location /ocsinterface>
SetHandler perl-script
PerlHandler Apache::Ocsinventory::SOAP
# By default, you can query web service from everywhere with a valid user
Order deny,allow
Allow from all
AuthType Basic
AuthName "OCS Inventory SOAP Area"
# Use htpasswd to create/update soap-user (or another granted user)
AuthUserFile "/etc/apache2/passwd/soapinterface"
Require valid-user
</Location>
出于安全目的,您应该为此位置创建一个密码,但是,要关闭身份验证,只需注释掉所有身份验证和需要属性。
重新启动apache服务器,并使用下面的PHP代码测试web服务集成
<?php
$proto = 'http';
$host = 'localhost';
$port = '80';
$user = ''; //basic authentication, if necessary
$pass = '';
$options = array(
'location' => "$proto://$host:$port/ocsinterface",
'uri' => "$proto://$host:$port/Apache/Ocsinventory/Interface",
'login' => $user,
'password' => $pass,
'trace' => TRUE,
'soap_version' => SOAP_1_1,
);
$request = '
<REQUEST>
<ENGINE>FIRST</ENGINE>
<ASKING_FOR>META</ASKING_FOR>
<CHECKSUM>131071</CHECKSUM>
<OFFSET>0</OFFSET>
<WANTED>131071</WANTED>
</REQUEST>';
try {
$client = new SoapClient(NULL, $options);
} catch (Exception $e) {
echo "<b>Construct Error</b>: " . $e->getMessage() . "<br>";
}
try {
$result = $client->get_computers_V1($request);
echo "<b>Headers:</b><pre>" . $client->__getLastRequestHeaders() . " </pre><br>";
echo "<b>Request:</b><pre>" . $client->__getLastRequest() . "</pre><br>";
echo "<b>Result:</b><pre>";
var_dump($result);
echo "</pre><br>";
} catch (Exception $e) {
echo "<b>Connection Error</b>: " . $e->getMessage() . "<br><br>";
echo "<b>Headers:</b><pre>'r'n" . $client->__getLastRequestHeaders() . " </pre><br>";
echo "<b>Request:</b><pre>'r'n" . $client->__getLastRequest() . "</pre>";
}
如果您收到HTTP 500内部服务器错误,请查看apache错误日志(tail -f /var/log/apache2/error.log -n 100
)中的以下错误消息:
/usr/local/share/perl/5.18.2/SOAP/Transport/HTTP2.pm第103行的非法字段名"APR::Table=HASH(0x7ff114bd75a8)"。''n
发生该错误的原因是在HTTP::Message-perl模块中发现了不兼容问题。以下链接描述了与此相关的问题和解决方案:
- http://ask.ocsinventory-ng.org/735/demande-dinformations-web-service-ocs-inventory
- https://www.tnpi.net/support/forums/index.php?topic=1037.0
要修复它,您需要将HTTP::Message perl模块降级到版本6.04。在控制台中使用命令cpan -D HTTP::Message
来检查您使用的是哪个版本。这个模块版本有点旧,所以你不会在搜索CPAN中找到它。在这方面,您应该下载模块HTTP-Message-6.04.tar.gz,并通过在终端上键入以下命令手动安装:
- 使用
tar -zxf HTTP-Message-6.04.tar.gz
解压缩 - 调用新目录
cd HTTP-Message-6.04/
perl Makefile.PL
make
make test
make install
- 最后,通过键入
cpan -D HTTP::Message
检查模块是否成功降级(它应该输出…Installed:6.04…) - 重新启动服务器-
service apache2 restart
运行上面显示的PHP代码段来再次测试它。