센서 데이터 수집 시스템 구축 1 - 개인페이지 서버
라즈베리파이가 보낸 측정값을 kgorani.kr 에서 받아 DB에 저장하는 부분
- 설정 : public_html/config/config.php
- 검증 함수 : public_html/includes/sensor.php
- 수신 주소 : public_html/api/sensor.php → https://kgorani.kr/api/sensor.php
보안 처리
- 토큰 인증 (hash_equals 로 비교 → 응답 시간으로 토큰 추측 불가)
- HTTPS 요청만 허용
- 측정값마다 범위 · 형식 · 시각 검사, Prepared Statement 로 저장
- 요청 크기 256KB, 한 번에 500개 제한
- 측정 시각 UNIQUE + INSERT IGNORE 로 재전송 중복 방지
- 세션 · 접속 기록을 쓰지 않아 메인 화면의 최근 접속 IP 에 섞이지 않음
파일 위치
- DB 테이블 : sensor_readings (kgorani DB)- 설정 : public_html/config/config.php
- 검증 함수 : public_html/includes/sensor.php
- 수신 주소 : public_html/api/sensor.php → https://kgorani.kr/api/sensor.php
1. DB 테이블
USE kgorani;
CREATE TABLE sensor_readings (
id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
measured_at DATETIME NOT NULL, -- 라즈베리파이에서 측정한 시각
temperature DECIMAL(4,1) NULL, -- 온도 (°C), 측정 실패 시 NULL
humidity DECIMAL(4,1) NULL, -- 습도 (%), 측정 실패 시 NULL
light TINYINT(1) NULL, -- 전등 1=켜짐 0=꺼짐
received_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, -- 서버가 받은 시각
PRIMARY KEY (id),
UNIQUE KEY uq_sensor_measured (measured_at) -- 같은 측정값이 재전송돼도 한 번만 저장
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;2. 토큰 만들기 · config.php 설정
php -r 'echo bin2hex(random_bytes(32)), "\n";'나온 64글자를 config.php 와 라즈베리파이 서버 .env 에 똑같이 넣는다// ── 라즈베리파이 센서 API ────────────────────────────────────
const SENSOR_API_TOKEN = '여기에_토큰';
const SENSOR_REQUIRE_HTTPS = true; // HTTPS 요청만 받음 (토큰이 평문으로 오가지 않게)3. includes/sensor.php
<?php
/**
* 라즈베리파이 센서 데이터 — 공통 함수
* 사용처: api/sensor.php (수신), RASPBERRY PI 페이지 (표시)
*/
if (!defined('APP_INIT')) { http_response_code(403); exit; }
date_default_timezone_set('Asia/Seoul');
const SENSOR_MAX_BATCH = 500; // 한 번에 받을 수 있는 측정값 개수
const SENSOR_MAX_AGE_DAYS = 30; // 이보다 오래된 측정값은 거부
/** 라즈베리파이가 보낸 토큰 확인 (타이밍 공격 방지를 위해 hash_equals) */
function sensor_token_ok(string $sent): bool
{
if (!defined('SENSOR_API_TOKEN') || strlen(SENSOR_API_TOKEN) < 32) {
return false; // 토큰이 설정되지 않았거나 너무 짧으면 무조건 거부
}
return $sent !== '' && hash_equals(SENSOR_API_TOKEN, $sent);
}
/**
* 측정값 1개 검증
* 통과: ['measured_at' => ..., 'temperature' => ..., 'humidity' => ..., 'light' => ...]
* 실패: null
*/
function validate_reading($r): ?array
{
if (!is_array($r)) {
return null;
}
// 측정 시각: 'YYYY-MM-DD HH:MM:SS', 미래(5분 이상) 또는 30일 넘게 지난 값은 거부
$at = $r['measured_at'] ?? null;
if (!is_string($at)) {
return null;
}
$d = DateTimeImmutable::createFromFormat('!Y-m-d H:i:s', $at);
if (!$d || $d->format('Y-m-d H:i:s') !== $at) {
return null;
}
$now = new DateTimeImmutable();
if ($d > $now->modify('+5 minutes') || $d < $now->modify('-' . SENSOR_MAX_AGE_DAYS . ' days')) {
return null;
}
// 숫자 범위 검사 (DHT11 측정 범위보다 넉넉하게)
$num = function ($v, float $min, float $max) {
if ($v === null) {
return null;
}
if (!is_int($v) && !is_float($v)) {
return false;
}
return ($v < $min || $v > $max) ? false : round((float)$v, 1);
};
$t = $num($r['temperature'] ?? null, -40, 80);
$h = $num($r['humidity'] ?? null, 0, 100);
if ($t === false || $h === false) {
return null;
}
// 전등: 1(켜짐) / 0(꺼짐) / null(측정 안 함)
$l = $r['light'] ?? null;
if (is_bool($l)) {
$l = (int)$l;
}
if ($l !== null && $l !== 0 && $l !== 1) {
return null;
}
if ($t === null && $h === null && $l === null) {
return null; // 아무 값도 없는 측정은 저장하지 않음
}
return ['measured_at' => $at, 'temperature' => $t, 'humidity' => $h, 'light' => $l];
}4. api/sensor.php
<?php
/**
* 센서 데이터 수신 API — 라즈베리파이의 collector.py 가 호출
*
* 요청: POST, Content-Type: application/json
* 헤더 X-Sensor-Token: (config.php 의 SENSOR_API_TOKEN 과 같은 값)
* 본문 {"readings": [{"measured_at": "2026-11-17 18:00:00", "temperature": 23.5, "humidity": 41, "light": 1}, ...]}
* 응답: {"ok": true, "received": 3, "saved": 3, "rejected": 0}
*
* init.php 를 쓰지 않는 이유: 1분마다 오는 요청이 세션 · 접속 기록(최근 접속 IP)에 쌓이지 않게
*/
define('APP_INIT', true);
require __DIR__ . '/../config/config.php';
require __DIR__ . '/../includes/db.php';
require __DIR__ . '/../includes/sensor.php';
header('Content-Type: application/json; charset=utf-8');
header('X-Content-Type-Options: nosniff');
header('Cache-Control: no-store');
function reply(int $code, array $data): never
{
http_response_code($code);
echo json_encode($data, JSON_UNESCAPED_UNICODE);
exit;
}
// 1) POST 만 허용
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
reply(405, ['ok' => false, 'message' => 'POST 요청만 받습니다.']);
}
// 2) HTTPS 강제 (토큰이 평문으로 오가지 않도록)
$isHttps = !empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off';
if (SENSOR_REQUIRE_HTTPS && !$isHttps) {
reply(403, ['ok' => false, 'message' => 'HTTPS 로만 전송할 수 있습니다.']);
}
// 3) 토큰 확인
if (!sensor_token_ok((string)($_SERVER['HTTP_X_SENSOR_TOKEN'] ?? ''))) {
error_log('센서 API 인증 실패: ' . ($_SERVER['REMOTE_ADDR'] ?? '?'));
reply(401, ['ok' => false, 'message' => '인증 실패']);
}
// 4) 본문 읽기 (최대 256KB)
$raw = file_get_contents('php://input', false, null, 0, 262145);
if ($raw === false || strlen($raw) > 262144) {
reply(413, ['ok' => false, 'message' => '요청이 너무 큽니다.']);
}
$body = json_decode($raw, true);
if (!is_array($body) || !isset($body['readings']) || !is_array($body['readings'])) {
reply(400, ['ok' => false, 'message' => 'JSON 형식이 올바르지 않습니다.']);
}
if (count($body['readings']) > SENSOR_MAX_BATCH) {
reply(413, ['ok' => false, 'message' => '한 번에 최대 ' . SENSOR_MAX_BATCH . '개까지 보낼 수 있습니다.']);
}
// 5) 하나씩 검증 → 통과한 것만 저장
$valid = [];
foreach ($body['readings'] as $r) {
$v = validate_reading($r);
if ($v !== null) {
$valid[] = $v;
}
}
$saved = 0;
try {
$pdo = db();
$pdo->beginTransaction();
// 같은 측정 시각이 다시 오면(재전송) 무시 → 중복 저장 방지
$ins = $pdo->prepare(
'INSERT IGNORE INTO sensor_readings (measured_at, temperature, humidity, light) VALUES (?, ?, ?, ?)'
);
foreach ($valid as $v) {
$ins->execute([$v['measured_at'], $v['temperature'], $v['humidity'], $v['light']]);
$saved += $ins->rowCount();
}
$pdo->commit();
} catch (PDOException $e) {
if (isset($pdo) && $pdo->inTransaction()) {
$pdo->rollBack();
}
error_log('센서 데이터 저장 실패: ' . $e->getMessage());
reply(500, ['ok' => false, 'message' => '저장 실패']);
}
reply(200, [
'ok' => true,
'received' => count($body['readings']),
'saved' => $saved,
'rejected' => count($body['readings']) - count($valid),
]);5. 저장 확인
SELECT * FROM kgorani.sensor_readings ORDER BY id DESC LIMIT 10;보안 처리
- 토큰 인증 (hash_equals 로 비교 → 응답 시간으로 토큰 추측 불가)
- HTTPS 요청만 허용
- 측정값마다 범위 · 형식 · 시각 검사, Prepared Statement 로 저장
- 요청 크기 256KB, 한 번에 500개 제한
- 측정 시각 UNIQUE + INSERT IGNORE 로 재전송 중복 방지
- 세션 · 접속 기록을 쓰지 않아 메인 화면의 최근 접속 IP 에 섞이지 않음