Merge pull request 'Add application API keys' (#55) from codex/application-api-keys into main

Reviewed-on: OpenSource/KanbanGit#55

app/Models/User.php

@@ -63,6 +63,13 @@ class User extends Authenticatable
             ->orderBy('base_url');
     }
 
+    public function userApplications(): HasMany
+    {
+        return $this->hasMany(UserApplication::class)
+            ->orderBy('name')
+            ->orderBy('id');
+    }
+
     public function assignedTickets(): HasMany
     {
         return $this->hasMany(Ticket::class, 'assignee_user_id');

app/Models/UserApplication.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Models;
+
+use Database\Factories\UserApplicationFactory;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Attributes\Hidden;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Support\Str;
+
+#[Fillable(['key_hash', 'last_used_at', 'name', 'user_id'])]
+#[Hidden(['key_hash'])]
+class UserApplication extends Model
+{
+    /** @use HasFactory<UserApplicationFactory> */
+    use HasFactory;
+
+    public static function generatePlainTextKey(): string
+    {
+        return 'kg_app_'.Str::random(64);
+    }
+
+    public static function hashKey(string $plainTextKey): string
+    {
+        return hash_hmac('sha256', $plainTextKey, (string) config('app.key'));
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'last_used_at' => 'datetime',
+        ];
+    }
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}