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

时间:2016-04-20 17:49:32

标签: php linux apache perl perl-module

如何启用OCS WebServices中描述的OCS清单界面?是否有在PHP中使用此Web服务的示例代码?

1 个答案:

答案 0 :(得分:4)

默认情况下禁用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 Documentation中提供的文档。

检查 / 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>

出于安全考虑,您应该为此位置创建密码,但要关闭身份验证,只需注释掉所有 Auth ... 需要 属性。

重启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)以获取以下错误消息:

  

非法字段名称&#39; APR :: Table = HASH(0x7ff114bd75a8)&#39;在/usr/local/share/perl/5.18.2/SOAP/Transport/HTTP2.pm第103行。\ 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
  3. 要修复它,您需要将HTTP :: Message perl模块降级到版本 6.04 。使用控制台中的cpan -D HTTP::Message命令检查您正在使用的版本。此模块版本有点旧,因此您无法在Search CPAN中找到。在这方面,您应该下载模块HTTP-Message-6.04.tar.gz并通过在终端上键入以下命令手动安装它:

    1. 使用tar -zxf HTTP-Message-6.04.tar.gz
    2. 对其进行解压缩
    3. 调用新目录cd HTTP-Message-6.04/
    4. perl Makefile.PL
    5. make
    6. make test
    7. make install
    8. 最后,通过键入cpan -D HTTP::Message检查模块是否成功降级(它应输出 ...已安装:6.04 ...
    9. 重启服务器 - service apache2 restart
    10. 运行上面显示的PHP代码段以再次测试它。