kBackupのはじめ方

kintoneのアプリをkBackupに登録し、データが毎日自動でバックアップされることを確かめるまでの手順です。

このページの流れ

動画で流れを見たい方はこちら(約5分)

見たいところから再生できます:
ログインしてkintoneとつなぐ(0:55~1:55)/バックアップするアプリを登録する(1:56~3:49)/バックアップが取れたことを確かめる(3:50~4:27)

※動画内では本ページでご案内しております、定期バックアップを取得するまでの方法に加え、
定期バックアップの取得時間の設定/リアルタイムバックアップの設定/アプリテンプレートの追加設定/監査ログの確認方法も紹介しています。最初のバックアップを確かめた後で試してみてください。

中断された場合は、進み具合に合わせて続きから始められます。

どこから始めるかわからないとき

どこから始めるかわからないときは、ログインしてみてください。
ログイン後、kintoneのURLを入れる画面が出る→手順2へ
バックアップ保存先の画面が出る→手順3へ
「アプリ一覧」画面に登録したアプリ名が表示される→手順12へ
「アプリ一覧」画面にアプリ名が表示されない→手順4へ


ログインしてkintoneとつなぐ

kBackupの設定は、kintoneの画面上ではなく、kBackupの管理画面で行います。
kintoneのURLを入力して連携し、バックアップの保存先を設定します。この作業は最初の1回のみで問題ありません。

1.kBackupの管理画面からログインする

ログイン後、サービス一覧の画面が表示される場合は、kBackupの[開く]ボタンをクリックします。

うまくいかないとき:ログインできない

2.kintoneのURLを入力して[次へ]する
kintoneのURL(https://(サブドメイン名).cybozu.com)を入力し、[次へ]をクリックします。

うまくいかないとき:[次へ]を押せない・エラーが発生する
  • エラー文言:「kintone URLが正しくありません。」
    →URLの形を確認してください。最後が.cybozu.comで終わる形です。アプリのURL(/k/123/などが付いたもの)ではありません。
  • エラー文言:「kintoneとの接続中に問題が発生しました。IP制限されているか、認証情報が間違っています。」
    →会社でアクセスできる場所を制限している場合(cybozu.comにIPアドレス制限を掛けている場合)、kBackupのIP「54.64.62.173」「52.197.118.0」を許可する設定が必要です。この設定はcybozu.comの管理者しかできないため、管理者に依頼してください。詳しくはkBackup利用時のセキュリティの設定をご確認ください。
  • エラー文言:「アクセスするには認証が必要です。」
    →Basic認証を使っている場合のエラーです。[Basic認証を利用している]にチェックを入れ、ユーザー名とパスワードを入力して保存します。

3.バックアップ保存先を設定する

[kBackupに保存]にチェックが入っていることを確認し、[保存]をクリックします。

補足
基本的には[kBackupに保存]のままで問題ありません。社外にデータを保持しない要件があるなど、自社のAWS環境に保存したい場合は、自社AWS環境へバックアップするをご覧ください。(エンタープライズコースにてご利用可能となります。)

バックアップするアプリを登録する

kBackupにバックアップするアプリを登録します。
レコード(データ)が1件以上入っているアプリを使います。
※レコードが0件だとバックアップが取得されず『リトライ待ち』になります。

4.使うkintoneアプリを用意して、URLをコピーする

アプリを開いたときのブラウザのURLをコピーします。https://(サブドメイン名).cybozu.com/k/123/ のような形です。

補足
ゲストスペースのアプリ(/k/guest/〇/〇/ のような形)も、そのまま使えます。
使えるアプリがない場合

kintoneの「アプリストア」から、サンプルデータが入ったアプリをすぐに作れます。試すだけなら、これが一番カンタンです。おすすめは「顧客リスト」アプリです。

①kintoneの画面上で、アプリの[+]ボタンをクリックします。


②左側の「アプリを探す」の入力欄に「顧客リスト」と入力し、表示された顧客リストアプリの行の[このアプリを追加]>[追加]とクリックして作成します。


③作成されたアプリを開き、ブラウザのURLをコピーします。https://(サブドメイン名).cybozu.com/k/123/ のような形です。

補足
自分で作ったアプリには「アプリ管理」の権限が最初から付いているので、APIトークンもそのまま作れます。ただし、手順9~10のJavaScriptの設定には、「cybozu.com共通管理者」または「kintoneシステム管理者」の権限が必要です。アプリストアが使えない(アプリを作る権限がない)場合は、kintoneの管理者にご相談ください。

5.kBackupで[+バックアップ対象を追加]をクリックする


6.アプリのURLを貼り付けて「APIトークン生成はこちら」をクリックする

手順4でコピーしたURLを「kintoneアプリのURL」に貼り付けます。続けて「APIトークン生成はこちら」をクリックすると、別のタブでkintoneの画面が開きます。

APIトークンは、kBackupがkintoneのデータを読み取ってバックアップするための合い言葉のようなものです。


7.kintoneでAPIトークンを作り、[保存]→[アプリを更新]まで押す

開いた画面で[生成する]をクリックし、権限の「レコード閲覧」にチェックが入っていることを確認します。
続けてAPIトークンをコピーしたら、[保存]をクリックし、続けて[アプリを更新]をクリックします。

[生成する]だけでは終わりません
トークンを作ったら、次の2つを順番に押してください。どちらかを忘れると、作ったAPIトークンは使えません。
  • [保存](APIトークンの画面の下)
  • [アプリを更新](画面の上部)
kBackupに戻る前に、この2つを押したか確認してください。
うまくいかないとき:[生成する]のボタンがない・設定画面が開けない

APIトークンを作れるのは、そのアプリの「アプリ管理」の権限を持っている人だけです。アプリを開いて、アプリ画面右上、レコード追加の「+」ボタンの右側に歯車のマーク(アプリの設定)が出ていなければ、権限がありません。

その場合は、kintoneの管理者に次のいずれかを依頼してください。

  • そのアプリの「アプリ管理」の権限をもらう
  • APIトークン(権限は「レコード閲覧」)を作ってもらう

依頼文例:kBackup(kintoneのデータを自動でバックアップするサービス)を試しています。
「〇〇」アプリについて、アプリ管理の権限をいただくか、「レコード閲覧」の権限をつけたAPIトークンを発行していただけますか。


8.kBackupに戻ってAPIトークンを貼り付け、[保存]をクリックする

コピーしたAPIトークンを貼り付けます。「アプリ管理名」には、自分がわかる名前(例:顧客リスト)を入れます。

うまくいかないとき:[保存]でエラーになる
  • エラー文言:「情報の取得に失敗しました。APIトークンが正しいかお確かめください。」
    →手順7で[保存]または[アプリを更新]を押していない可能性があります。再度kintoneアプリ側で保存、アプリを更新してからAPIトークンを貼り付け、[保存]してください。
  • エラー文言:「情報の取得に失敗しました。APIトークンに「レコード閲覧権限」のアクセス権が設定されているかお確かめください。」
    →APIトークンに「レコード閲覧」の権限がついていない可能性があります。再度kintoneアプリ側にて「レコード閲覧」の権限を付与し、保存、アプリを更新してからAPIトークンを貼り付け[保存]してください。
  • エラー文言:「APIトークンとアプリ(id: 〇〇〇)の組み合わせが正しくありません。」
    →アプリのURLとAPIトークンが別のアプリのものである可能性があります。再度kintoneアプリのURLが正しいことを確認し、「APIトークン生成はこちら」からアクセスして、手順7→手順8と進んでください。

9.JavaScriptをダウンロードし、[kintoneの設定]をクリックする

保存すると、JavaScriptをダウンロードする画面が表示されます。[JavaScript]をクリックしてファイルをダウンロードし、続けて[kintoneの設定]をクリックします。kintoneのアプリの設定画面が開きます。

このJavaScriptを設定すると、kintoneのアプリの画面にバックアップ状況が表示されます。kBackupにログインしない人にも、データがバックアップされていることが見えるようになります。

この画面を閉じてしまった・あとから登録する場合

kBackupの『アプリ一覧』画面でアプリを開き、[アプリの概要]→「JavaScriptダウンロード」の[設定に進む]をクリックすると、同じ画面を開けます。


10.kintoneにJavaScriptをアップロードし、[保存]→[アプリを更新]まで押す

「PC用のJavaScriptファイル」の[アップロードして追加]をクリックし、手順9でダウンロードしたファイルを選びます。
右下の[保存]をクリックし、続けて右上の[アプリを更新]をクリックします。

※古いkBackupのJavaScriptが入っている場合は、削除してから新しいファイルをアップロードしてください。

[保存]だけでは終わりません
[アプリを更新]まで押さないと、kintoneの画面にバックアップ状況が表示されません。
kBackupに戻る前に、[アプリを更新]を押したか確認してください。
うまくいかないとき:設定画面が開けない・アップロードの欄がない

JavaScriptを設定するには、「cybozu.com共通管理者」または「kintoneシステム管理者」の権限が必要です。
kintone上部の歯車アイコンを開き、「cybozu.com共通管理者」または「kintoneシステム管理者」の表示がなければ、権限がありません。

権限がない場合は、ダウンロードしたファイルを添えて、kintoneの管理者に設定を依頼してください。

依頼しているあいだも、毎日の定期バックアップは取れます。画面の[×]で閉じて、手順12に進んでください([登録完了]はJavaScriptを設定しないと押せませんが、[×]で閉じてもアプリの登録は済んでいます)。

  依頼文例:kBackup(kintoneのデータを自動でバックアップするサービス)を試しています。
「〇〇」アプリに、kBackupのJavaScriptファイルを設定していただけますか。kintoneの画面にバックアップ状況を表示するためのものです。ファイルを添付します。


11.kBackupに戻って[登録完了]をクリックする

kintoneでの登録が終わったら、kBackupの画面に戻ります。
『JavaScriptをアップロード』の画面で、[登録完了]をクリックします。


バックアップが取れたことを確かめる

アプリを登録すると、「バックアップ予約済み」となり、数分〜十数分程度で最初のバックアップが取得されます。
しばらく待ってから、kBackupのアプリ一覧画面とkintoneのアプリの画面で、バックアップが取れていることを確かめます。

12.アプリ一覧画面で定期バックアップの取得を確認する

kBackupのアプリ一覧画面を開きます。
登録したアプリの行の、「稼働状況」に「稼働中」と表示され、定期バックアップを取った時間とレコード数が表示されていれば成功です。
レコード数が、kintoneのアプリのレコードの件数と同じであれば、すべてのレコードがバックアップされています。

うまくいかないとき:定期バックアップが取得されない
  • アプリ登録後すぐ→kBackupにアプリを登録した時点からバックアップの処理の準備を始め、数分~十数分程度で初回のバックアップを取得します。そのため、しばらく待ってから、画面を再読み込みしてください。
  • 稼働状況が「リトライ待ち」になる→アプリのレコードが0件の可能性があります。レコードが1件以上あるアプリを利用してください。稼働状況について
  • 稼働状況に「エラー」と表示されている→エラーの通知メール、または下のエラー一覧で原因と対処を確認してください。バックアップ時のエラー

13.kintoneのアプリの画面で、バックアップ状況を確認する

kintoneで登録したアプリを開きます。
kBackupのアイコンが表示され、バックアップ状況が確認できれば完了です。

うまくいかないとき:kBackupのアイコンが表示されない
  • 手順10で[アプリを更新]まで押したか確認してください。押している場合は、kintoneの画面を再読み込みしてください。
  • JavaScriptの設定を管理者に依頼している場合は、設定が終わってから確認してください。

これで最初のバックアップが取れました
登録したアプリのデータは、これから毎日1回、自動でバックアップされます。バックアップ状況は、kintoneのアプリの画面でも確認できます。


次に試すこと

1つバックアップを確認できたら、目的に合わせて次の設定を試してみてください。

リアルタイムにバックアップする

1日1回の定期バックアップに加えて、レコードの追加・編集・削除のたびにバックアップを取れます。
リアルタイムバックアップを設定する
(※プレミアムコース以上で使えます(無料お試し中は利用できます))

1件だけデータを戻してみる

バックアップから、指定したレコード1件だけを戻せます。現在利用中のアプリにそのまま戻すことも可能です。
1レコードリストアをする

ほかの人と一緒に設定する

管理者・編集者のアカウントを追加して、複数人でkBackupの設定画面にログインし、自分の管理するアプリのみ確認してもらうことも可能です。
ライセンス管理機能について
ユーザーライセンスについて

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です