この固定ページが、Copper PDFドライバ情報の最新の正本です。
Copper PDFサーバーを各種アプリケーションから利用するためのドライバです。サーバー本体はCopper PDFサーバーのダウンロードページから入手してください。
現在は、GitHubおよび各言語のパッケージマネージャ経由でのインストールを推奨しています。
対応言語
- Java
- .NET / C# / VB.NET
- Node.js
- PHP
- Python
- Perl
- Ruby
どのドライバを使えばよいか
| 利用環境 | 推奨ドライバ |
|---|---|
| Java | Javaドライバ |
| C# / VB.NET | .NETドライバ |
| Node.js | Node.jsドライバ |
| PHP | PHPドライバ |
| Python | Pythonドライバ |
| Perl | Perlドライバ |
| Ruby | Rubyドライバ |
各ドライバのインストールコマンド、GitHubリポジトリ、APIドキュメントへのリンクは以下にまとめています。古いRPM、DEB、zip、tar.gz形式の配布物は、各言語の「レガシー版ダウンロード」にまとめています。
目次
Java ドライバ
Maven / Gradle（JitPack経由）でインストールできます。v2.3.2 より前の座標は JitPack で正しく解決できませんでした。v2.3.2 以降を指定してください。
Gradle
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
dependencies {
implementation 'com.github.zamasoftnet:cti.java:v2.3.2'
}Maven
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependency>
<groupId>com.github.zamasoftnet</groupId>
<artifactId>cti.java</artifactId>
<version>v2.3.2</version>
</dependency>アーカイブのダウンロード
cti-java-2.3.2.zip
cti-java-2.3.2.tar.gz
リポジトリ: https://github.com/zamasoftnet/cti.java
APIドキュメント: https://zamasoftnet.github.io/cti.java/
レガシー版ダウンロード
以下はバージョン1ドライバです。
cssj-driver-java-1_0_7.tar.gz
cssj-driver-java-1_0_7.zip
.NET(C# / VB.NET)ドライバ
NuGetからインストールできます。.NET Standard 2.0以降対応（.NET Framework 4.6.1+ / .NET Core 2.0+ / .NET 5–9）。
dotnet add package Zamasoft.CTI --version 2.2.2リポジトリ: https://github.com/zamasoftnet/cti.net
NuGet: https://www.nuget.org/packages/Zamasoft.CTI/
APIドキュメント: https://zamasoftnet.github.io/cti.net/
レガシー版ダウンロード
以下は旧バージョン（.NET Framework 4.0向け）のアーカイブです。
cti-dotnet-2_0_1.zip
Node.js ドライバ
GitHubリポジトリからnpmでインストールしてください。Node.js 14以降が必要です。
npm install https://github.com/zamasoftnet/cti.nodejs.gitアーカイブのダウンロード
cti-nodejs-1.1.0.zip
cti-nodejs-1.1.0.tar.gz
リポジトリ: https://github.com/zamasoftnet/cti.nodejs
APIドキュメント: https://zamasoftnet.github.io/cti.nodejs/
Perl ドライバ
cpanmでインストールできます。Perl 5.6.1以降が必要です。
cpanm https://github.com/zamasoftnet/cti.perl/archive/refs/heads/main.tar.gzアーカイブのダウンロード
cti-perl-2.1.5.zip
cti-perl-2.1.5.tar.gz
リポジトリ: https://github.com/zamasoftnet/cti.perl
APIドキュメント: https://zamasoftnet.github.io/cti.perl/
レガシー版ダウンロード
cti-perl-2.1.3-0.noarch.rpm
cti-perl_2.1.3-1_all.deb
cti-perl-2_1_3.zip
cti-perl-2_1_3.tar.gz
以下はバージョン1ドライバです。
cssj-driver-perl-1_1_4.zip
cssj-driver-perl-1_1_4.tar.gz
PHP ドライバ
Composerでインストールできます。PHP 5.6以降が必要です。
composer require zamasoft/cti-phpアーカイブのダウンロード
cti-php-2.2.1.zip
cti-php-2.2.1.tar.gz
リポジトリ: https://github.com/zamasoftnet/cti.php
APIドキュメント: https://zamasoftnet.github.io/cti.php/
レガシー版ダウンロード
cti-php-2.1.4-0.noarch.rpm
cti-php_2.1.4-1_all.deb
cti-php-2_1_4.zip
cti-php-2_1_4.tar.gz
以下はバージョン1ドライバです。
cssj-driver-php-1_1_5.zip
cssj-driver-php-1_1_5.tar.gz
Python ドライバ
pipでインストールできます。Python 3が必要です。
pip install "git+https://github.com/zamasoftnet/cti.python.git#subdirectory=python3"アーカイブのダウンロード
cti-python-3.0.2.zip
cti-python-3.0.2.tar.gz
リポジトリ: https://github.com/zamasoftnet/cti.python
APIドキュメント: https://zamasoftnet.github.io/cti.python/
レガシー版ダウンロード
Python3
cti-python-rh9-3.0.0-0.noarch.rpm
cti-python-rh8-3.0.0-0.noarch.rpm
cti-python-3_0_0.zip
cti-python-3_0_0.tar.gz
cti-python_3.0.0-1_all.deb
Python 2以前
cti-python-rh7-2.0.0-0.noarch.rpm
cti-python-rh6-2.0.0-0.noarch.rpm
cti-python-rh5-2.0.0-0.noarch.rpm
cti-python-2_0_0.zip
cti-python-2_0_0.tar.gz
cti-python_2.0.0-1_all.deb
Rubyドライバ
RubyGems.org で公開しています。Ruby 1.8.7以降が必要です。
gem install copper-ctiBundlerをお使いの場合は、Gemfileに以下を追加してください。
gem 'copper-cti', '~> 2.2'アーカイブのダウンロード
cti-ruby-2.2.1.zip
cti-ruby-2.2.1.tar.gz
RubyGems: https://rubygems.org/gems/copper-cti
リポジトリ: https://github.com/zamasoftnet/cti.ruby
APIドキュメント: https://zamasoftnet.github.io/cti.ruby/
レガシー版ダウンロード
cti-ruby-2.1.0-0.noarch.rpm
cti-ruby_2.1.0-1_all.deb
cti-ruby-2_1_0.zip
cti-ruby-2_1_0.tar.gz
TLS（ctips:）で接続するには
Java 2.3.2、.NET 2.2.2、Node.js 1.1.0、Perl 2.1.5、PHP 2.2.1、Python 3.0.2、Ruby 2.2.1 以降は、ctips://ホスト名:ポート/ で TLS 接続できます。いずれもサーバー証明書とホスト名を検証します。
試験用に検証を省く指定は 7 本すべてにあります。Java は --insecure(または jp.cssj.driver.tls.insecure=true)、.NET は接続先 URI に ?insecure=1、Node.js は get_session() のオプション rejectUnauthorized: false、Ruby・PHP は 'insecure' => true、Python は 'insecure': True、Perl は insecure => 1 です。証明書もホスト名も確かめなくなるので、本番では使わないでください。
本番で自己署名や独自の認証局の証明書を使う場合は、その認証局を信頼させてください。Ruby・Perl・Python は環境変数 SSL_CERT_FILE、Node.js は NODE_EXTRA_CA_CERTS、Java はトラストストア、.NET は接続先 URI の ?cafile=証明書ファイル(2.2.2 以降)か OS のストア、PHP は openssl.cafile で指定します。
Copper PDF 3.2 のサーバーには TLS の待受が備わっています（既定では無効）。copperd.properties の次の行を有効にし、サーバー証明書を JKS 形式の鍵ストアに入れて conf ディレクトリに置いてください。TLS を終端する中継（Traefik など）をサーバーの前に置く構成でも同じです。
jp.cssj.cssjd.tls.port=8094
jp.cssj.cssjd.tls.keyStore=keystore
jp.cssj.cssjd.tls.keyStorePassword=password
jp.cssj.cssjd.tls.keyPassword=password