正在启用OCS Inventory WebService接口以查询资产数据


Enabling OCS Inventory WebService interface for querying assets data

如何启用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模块中发现了不兼容问题。以下链接描述了与此相关的问题和解决方案:

  1. http://ask.ocsinventory-ng.org/735/demande-dinformations-web-service-ocs-inventory
  2. 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,并通过在终端上键入以下命令手动安装:

  1. 使用tar -zxf HTTP-Message-6.04.tar.gz解压缩
  2. 调用新目录cd HTTP-Message-6.04/
  3. perl Makefile.PL
  4. make
  5. make test
  6. make install
  7. 最后,通过键入cpan -D HTTP::Message检查模块是否成功降级(它应该输出…Installed:6.04…
  8. 重新启动服务器-service apache2 restart

运行上面显示的PHP代码段来再次测试它。